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This manual describes the programming features of the UNIX system. 


INTRODUCTION 
1. INTRODUCTION 


It does not provide either a general overview of the UNIX system or 
details of the implementation of the system. 


This manual is divided into two sections, some containing inter-filed — 
sub-sections: 


e 1. Commands and Application Programs: 
e 1. General-Purpose Commands 

e 1C. Communications Commands 

e 1G. Graphics Commands 

e 6. Games 


Section 1 (Commands and Application Programs) describes programs 
intended to be invoked directly by the user or by command language 
procedures, aS opposed to subroutines, which are intended to be 
called by the user’s programs. Commands generally reside in the 
directory /bin (for binary programs). Some programs reside in 


_ /usr/bin to save space in /bin. These directories are searched 
automatically by the command interpreter called the shel/. Sub-. 
~~ gection 1C contains communication programs such as cu, send, uucp 


etc. These entries might not apply from system to system depending 
upon the hardware included on your processor. Some UNIX systems 
might have a directory called /usr/bin, which contains local 
commands. 


Section 6 (Games) describes the games and educational programs 
that usually reside in the directory /usr/games. 


Each section consists of a number of independent entries of a page 
or so each. The name of the entry appears in the upper corners of 
its pages. Entries within each section are alphabetized, except for 
the introductory entry that begins each section. Some entries might 
describe several routines, commands, etc., and in such cases the 
entry appears only once, under its major name. 
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All entries have a common format, not all of whose parts always 
appear: 


NAME gives the name(s) of the entry and briefly states its 
purpose. 


SYNOPSIS summarizes the program being described. A few 
conventions are used, particularly in Section 1 (Commands): 


Boldface strings are literals and are to be typed just as 
they appear. 


Italic strings usually represent substitutable prototypes 
and program names found elsewhere in the manual. 
(They are underlined in the the typed versions of the 
entries.) 


Square brackets ([ ]) around an argument prototype 
indicate that the argument is optional. When an 
argument prototype is given as name or file, it always 
refers to a file name. 


Ellipses (...) are used to show that the previous argument 
prototype might be repeated. 


A final convention is used by itself. An argument — 
beginning with a minus (=), plus ( +), or equal sign (=) is 
often a flag argument, even if it appears in a position 
where a file name could appear. Therefore, it is unwise 
to have files whose names begin with -,+, or =. 


DESCRIPTION discusses the subject at hand. 
FILES gives the file names that are built into the program. 
SEE ALSO gives pointers to related information. 


DIAGNOSTICS discusses the diagnostic indications that might 
be produced. Self-explanatory messages are not listed. 


WARNINGS points out potential pitfalls. 


BUGS gives known bugs, and sometimes, deficiencies. 
Occasionally the suggested fix is also described. 


A table of contents precedes the first section. On most systems, all 
entries are available on-line via the man(7) command. 
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INU Os otccoGee eae introduction to commands and application programs 
DOO sissies ccsciassecnsenieuigus handle special functions of DAS! 300 and 300s terminals 
BOT aos tnieshiewiaan eealetopee nesses paginator for the TEKTRONIX 4014 terminal 
G50 cic sieaerete Aina aes handle special functions of the DAS! 450 terminal 
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WN iiss iGansi acces cant ineecthealedetertaeee pattern scanning and processing language 
DANO i occas acendescsecaveseaecsns ues sande stbsdaas bese erecuts Socasapevenausaden¥asidcoasNeneeeen make posters 
DAR oe iccivet etic cc cdusveces eeuserisereeasahecsaesaactincas Berkeley archive and library maintainer 
DA SON AIO oss ciccis es ciscie a sawicasstwosateance ie chidsesemaaites deliver portions of path names 
DD AIO Fini siecscrdtecGisvasebessssnawsivceataeentetiehciateumes print large banner on printer 
DG ote ieee awe e eae arbitrary-precision arithmetic language 
DOCHIEE waa cease Wo seea etcucewestelce coakuduacutuctieaaaccee ue wubqncreyarcetvatauatosesectuwusacaceuats big diff 
BOS eh seseenc ace eceseetescreicsceumcunevad caamosusuiieusccea cs cae et vonann cats etancboosacennoneeuct big file scanner 
BB scesest eet ee cea che atepveneanntecaesaeicanesivaseneeemuessceattaceseeaee list contents of directory 
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CALORIE fis coeiassi cociseanssscceicrsaresvicen sae ennai deavesses awanetascexeavesrevuauaneceens reminder service 
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CD ios sieaaues aires gen neepn sean eae tala eecsw na eet oe etn mageensanees C program beautifier 
reece des cutenc tr ewasene cetera Daucus te uciensundcvastcuctacees sav aser tealces teoisssdnnonansoeeee C compiler 
CG acatesteicaceneans Sdidale dle sishle ava tudasaeid detec @ansBanegesensenedacethies ts change working directory 
col 0 | > RP REAR Oar Gite, inet ar er oer change the delta commentary of an SCCS delta 
OW soi saes icin ead cacicnranseedowspsssyetints Ge maeteer eco ran esa noeeate: generate C flow graph 
GINO iscsi 2s ecss ata cesta wcntonueredeveveatiecsenthsiaktwneenteauaecbeat eaasoialneeaeoeses change mode 
COW sce sccayscrsccdueeshcecsiaustanestiadseulicevseen scion tonseneaus acid. change owner or group 
CLO EE eis ce dass eisaven tre seusc sas otien caeunceneas sansa sai ouds cecsteaenaoaseeesances clear terminal screen 
CPD ch sisecsstewadianapersenssaeite vie inertavvinidem tetas Gaenetiameonas aun compare two files 
COL... suena civ asa rtuabasseviaacutecsssocccuepnesansseeuesiceunsseseniwenienee es filter reverse line-feeds 
COMA oy saiei css ccireencteuewatentas iene naeains aiaeeerseer eu aden ceerant combine SCCS deltas 
COMM serissieetctecescsaceyiaeivectiten select or reject lines common to two sorted files 
CD vie eae arviccas er iccalarssusavewupueccarecisaceiuscddasetemeacdtaaanteesoasteceeent copy, link or move files 
COLO aia coecoeaas Scie cintus ccnectaeteatvsveadereurtaraaisieaiowenans copy file archives in and out 
CDI sia sovehtuichcca ee caicatbiabravbnsgaebetteueiice tiated aasiets the C language preprocessor 
POND vole ncasntescvniateis wre eleadaicpanedvcnsin Ness budunceahgelewaauel suuseeewaudacued user crontab file 
CUO aiicowsseiniavacasivs ts aneaaunewonesaanswusatcnase conevawaneil a diokacsuewiaaan teieb igi encode/decode 
CSI cacaaiist i cccuacuscstiveracakdaesesancacael a shell (command interpreter) with C-like syntax 
SSDS acess soakiracacac sia cade pus torann wandiecanuebese uumunnciandelorsnveceswivessneesabeversabecaes context split 
OU sh cvethidvanidahancievanvadwaniaegtinnsasdeatesuden tie wasapivetauwanina spawn getty to a remote terminal 
CU isecrsicegestawasca ns uiunisioseesccoiateasaeueue wen itdancavuetinacante spawn getty to a remote terminal 
CLAGS ve iansdecesuwite tensa cedcriadiearcctiasannmaeiodaceinse bin areata ese eete ties create a tags file 
CUR RCG oases voces be ccduurdsscnmmeneunancnatisncmaanteaverdsnancaratecbiesineausineenes C program debugger 
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CG asso lacey ae eccoance hs ta pease een eota acess udulasebolceneecesaacautedenoeubiteas desk calculator 
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Opes y sslerss uarecace nds trade neatnadanmindeedaant caeniicabotoane eswsésacuesntoanusecunce DeecacesSevevbas text editor 
NE oa eevescavessccedtasiucnee Naveienceuloaversanvesen text editor (variant of ex for casual users) 
ON ascii raarysec as Suess sa sac ccitiassuswicssuwtnsdacaswediedaieenesearesedeunee Extended Fortran Language 
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(on od CRU TE POE Pn Oe PER Tn Rea ORE tee PO factor a number ~ 
TAO jee ies ao'vaccyiee as Pace ebsieccue ga ninaew ed acsecautosbatnsthutanayoasindese'nacaeseesaseise determine file type 
PNG oe fa stiecen warns dca can lncueaucauueceteg Saheuas cevencicuaaecwa seus bata eceiidevateevacdedGgavesaaaracooenn find files 
ES PONE aes A oouscess ok tse a eet paeiie earner eta es split £77, ratfor, or efl files 
GOV oireoiiecicremewisiivseeienices Soaateeeidebeceaeciteb nest graphical device routines and filters 
GOOG Vs gece ian tote ic reeteuseueseteienasnaes: graphical device routines and filters 

. SO ssid saccaeaeaavecaatediuidaszadecaueaidod de Aeesuuntn vabtar wie temisusterbontatans graphical editor 
GO iS scsselelonciae heaters Cee ee is graphical editor 
OU iaissicsclevessectcisiiccntensnwentiasel Aandi ns get a version of an SCCS file 
COTO DU so oaraspeee ae ccens eich accu eatwen na vcouauebusayentepeuneutadewesinns parse command options 
PRP coceies cece iscecscsran cas cania viva bass tad twee conan Caste ees draw a graph 
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OPIN CS eons vases teccecxce pi aetncnshtrentoetas access graphical and numerical commands 
CN ADINICS vcsssiccs covusascccesencawsecetasecncoees: access graphical and numerical commands 
CO Nc sss poo Sess ceca acsaauees sess unsreddonesauedessnensiiauwen aeons select terminal filter 
PS oi isacs sp eaceawa sacs wis cs ude ae ewan sescehce dace sneesauecunuunuesewens search a file for a pattern 
UTE co iveateccevecs sadcesease vie suiege oi canancatuanduessaccssewngatesamenes cdabaawewerannceests graphical utilities 
UU) sahara w aeacerne tea rantestseaseasacdsanraarcousniecasel wevacemeayivatetsa aeons graphical utilities 
BNO oaks verinnaheeiacbaxieveseateaiinctersuitieaiansen conte dorences give first few lines of a stream 
BUS cad hei us cace tists tele yaa eawan Usk Suc aweeccaac uur aanee eaaanca eee verecweneatialoncsctee lucas ask for help 
AD eisivvencniuncdencte handle special functions of HP 2640 and 2621-series terminals 
hyphen................... Ninisliaeln Sel bedcaaganiiee San etae banc uawentoveateadecsnceans find hyphenated words 
Novas asavsieseswaa nase ivusca eauicueyaneaisne ieee cesany ia csabeawieee print user and group IDs and names 
Ipcrm............08. remove a message queue, semaphore set or shared memory jm 
NDC Sicescncicnicien ete eedeadotantate report inter-process communication facilities stat | 
(Fer | er Re eee CP ono ee nA Meee ene aE Serre relational database operatv. 
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a troff macro package for oo... mv(5) 
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BCCOSS SaiiecGacic wee re access(2) 


accessibility of a file access ............0... access(2) 
accessibility of a file 0. access(2s) 
ACCOUNTING ACCT oo... eee cee tte ee eeenees acct(2) 
ACCOUNTING ACCICON 0... cee cere eeee acctcon(im) 
accounting commands acct ...... acct(1m) 
accounting data by user ID ......... diskusg(1m) 


November 1986 


PERMUTED INDEX 


per-process 

search and print process 
merge or add total 

return Fortran time 

command summary from per-process 
run daily 

or disable process accounting 
miscellaneous accounting commands 
accounting file format 
per-process accounting records 
print process accounting file(s) 
connect-time accounting 

or add total accounting files 
arccosine intrinsic function 
Advanced Communication 
signal signal specify Fortran 

kill all 

system 

system 

system 

print current SCCS file editing 
report process data and system 
formatting mosd the OSDD 
absolute debugger 

acctmerg merge or 

change or 

create and 

part of complex argument 
integer part intrinsic function 
set a process 

change data segment space 
brk change data segment space 
main memory 

fast main memory 

disk rram 

abbreviations file L-dialcodes 
of a document 
sort 

common archive file format 
maintainer for portable archives 
language bc 

Fortran 

for portable archives ar 

bar Berkeley 

format of cpio 

common 

archive header of a member of an 
common archive format convert 
files 

archive file Idahread read the 
tape file 

library maintainer for portable 
copy file 

Fortran 

atan2 Fortran 


November 1986 
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ACIVITY SACt a scnd once dinienct caowinesdecvstns sact(1) 

activity timex time a command, ............. timex(1) 
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alphabetic dialing 0.0.0.0... eee L-dialcodes(4) 
analyze surface characteristics .............. style(1) 

and/or merge files sort 0.000. sort(1) 
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argument list vorintf print ......0... vprintf(3S) 
argument list(s) and execute .................. xargs(1) 
argument vector getopt ........... ee getopt(3C) 
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atan2 FOnran iscsi nutscinunceawan: atan2(3F) 
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cuserid get 

getc get 

putc put 

map of ASCII 

gtty get terminal 
analyze surface 

stty set terminal 


November 1986 
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cat concatenate and print ....... cat(8) 

(Cr: | a Re ny ne ANE ae eee ee ne ery cat(1) 
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file(1) 
ioctl(2) 
devnm(im) 
gdev(1) 
font(5) 


df(1m) 
dformat(8) 
dial(1) 
dial(1) 
dial(3C) 
ratfor(1) 


L-dialcodes(4 


bdiff(1) / 
diff(1) 
diff3(1) 
dim(3F) 
sdiff(1) 
diffmk(1) 
diff(1) 
diff3(1) 
diffmk(1) 
dim(3F) . 
dir(4) 
dircmp(1) 
cpset(1m) 
dir(4) 


chdir(2) 
chroot(2) 
uuclean(1m) 
dircmp(1) 
unlink(2) 
chroot(im) 
getcwd(3C) 
Is(1) 
mkdir(1) 
mvdir(im) 
pwd(1) 
mknod(2) 
chdir(2s) 
acct(2) 

getty 
sadp(im) 
diskusg(1m) 
df(1m) 


ramdisk(1m) 


rram(7) 
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mmilint sroff/MM nroff/MM 
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macros mm oprint/check 

MM macro package for formatting 
macro package for formatting 


mmt typeset 
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intrinsic function dprod 
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float and 
convert string to 
intrinsic function 


distributed pseudo-random numbers 


pic troff 


preprocessor for 
provide 


rm Cipher Microstreamer tape 


summarize disk usage 
Communication acpdmp 
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“Intelligent Communication icpdmp 
extract error records from 
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object file dump 


dump incremental 


od octal 


selected parts of an object file 
duplicate an open file descriptor 
for the Xerox 9700 printer 


floating-point number to string 


text editor 


(variant of ex for casual users) 
print current SCCS file 


users edit text 


screen-oriented (visual) display 


text 
link 
graphic 


common assembler and link 


stream 


split f77, ratfor, or 
Extended Fortran Language 


accounting acct 


enable/disable LP printers 


enable 


for/ uuencode uudecode 
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diskusg - generate disk 0... diskusg(1m) 
dismount file system mount .........0.0.000. mount(1m) 
display editor based on ex Vi... vi(1) 
display profile data prof oo... prof(1) 
distance function hypot ......... ee hypot(3M) 
distributed pseudo-random numbers ..... drand48(3C) 
document compatibility checker ............. mmilint(1) 
GOCUMENT ANALYZE... ec eees style(1) 
documents formatted with the MM ........ mm(1) 
documents mm the 0.0.0... en mm(5) 
documents the OSDD adapter .............. mosd(5) 
documents, viewgraphs, and slides ....... mmt(1) 
doing what WhOdo oo... eeeeees whodo(1m) 
double precision product ............ dprod(3F) 
double routines oo... cree reees float(2s) 
double-precision number strtod .............. strtod(3C) 
dprod double precision... ee dprod(3F) 
drand48 generate uniformly ..........000000. drand48(3C) 
draw a graph graph... ee graph(1) 
drawing simple pictures ..............0..008. pic(1) 
drill in number facts arithmetic .........00.... arithmetic(6) 
GIVE: iscctia nna dedtvemianin Hones orsaceiatauangatenys rm(7) 
du summarize disk usage .............0.0... du(8) 
GU Ss ciereae thin Re io ener anatase du(1) 
dump contents of Advanced ...............4. acpdmp(1m) 
dump contents of an oo... ees icpdmp(im) 
GUMD errd ead ninco i eenees errdead(1m) 
GUM ON OG: -SeccceiceGies hetacst ve tren eaete od(1) 
dump selected parts of an ow, dump(1) 
dump tape format 0.0... eeees dump(4) 
GUID ccna ccayic on scasedectnee sete tiasveneecelecasnadiendt od(8) 
GUMOSOUIMND siteccdoaeseetneceun tees: dump(1) 
GUD inseesienrdevateiaieh mauris radu onssonaueian dup(2) 
dx9700 prepare troff documents ............ dx9700(1) 
echo arguments @CNO ou... eee echo(1) 
OCVE CONVOM sci intavedesiistnciatiadsieds ecvt(3C) 
CG! sericea cesnirk casa siestiss cisueh sedis oo uae aes ed(1) 
edit text Editor 0. ects edit(1) 
editing activity Sact 0. cee sact(1) 
editor (variant of ex for casual .............. edit(1) 
editor based ON CX Vi wu... ceeeeee es vi(1) 
GONOMOK: sencostan ote qrersnanncuasecaeuaueaaleton ex(1) 
editor for common object files Id ............ Id(1) 
BONO GOO a: cya inmrrndspreicas we ancadeeets ged(1) 
editor output 2.0Ut 0... eee a.out(4) 
GOIOl SOG: 4 say axtanterteieinile keener sed(1) 
OT TIAS: ISON cccsaveces cease cate retee td aeons fsplit(1) 
Cll Rea hseacicre aucune ae Achat deeh et wena acraapendas efi(1) 
enable or disable process .........0..0.004. acct(2) 
CM ADS ccsysdccrasbeeitecdianeieteei nates, cencawne enabie(1) 
enable/disable LP printers .....000.0000000. enable(1) 
encode/decode a binary file 0.00.0... uuencode(1c) 
encode/decode Crypt... eee crypt(1) 
ENCHYVPUON CH PY aieesaveis centre coherence crypt(3C) 
encryption key makekey ..............0.0000. makekey(1) 
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extract error records from dump 
error-logging daemon 
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system 
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the error-logging daemon 

line connection dial 
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end 
entries from name list nlist 
entries in a common object file 
entries in this manual man 
entries of a common object file 
entries of a section of a common 
entry formats utmp 
entry getgrent 
entry getpwent 


BMIPY QOTUE siwciiesitisotindiipraiineataoaselonetectonns 
entry Idgetname symboi name for .... 
entry of a common object file ............. 
entry of a common object file ............. 


entry putpwent 
entry unlink 
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environ 
environment at login time profile 
environment at login time 
environment environ 
environment for command execution 


environment name getenv ................. 


environment putenv 
environment variable getenv 
eqn and neqn eqnchar 
eqn constructs deroff 


eqn format mathematical text ............. 


erf error function 


errdead 
errdemon 
errfile 
error function and 
error messages perror 
error records from dump errdead 


error-handling function matherr .......... 


error-log file format errfile 
error-logging daemon errdemon 


error-logging daemon errstoo ............. 


error-logging interface err 
errors errpt 
errors spell 
errpt 


@rrstop terMinate 0... cece 


establish an out-going terminal 
establish mount table setmnt 


evaluate arguments aS an... 
evaluation COMMANG 0... cece cee ees 
ex for casual users) edit 0.0.0.0... 


ex vi screen-oriented 
examine system images crash 
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execute a command on the PCL 


execute a file @XEC oo... ccceccceececcees 
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UNIX-to-UNIX system command 
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create a new file or rewrite an 


terminate process 

EOT on the other terminal and 
exponential intrinsic function 
power, Square root function 
compress and 

conversion ftype 

exp Fortran 

square root function exp 
arguments as an expression 
routines regexp regular 
regular 

evaluate arguments as an 
compile and execute regular 
errdead 

Fortran 77 compiler 

split 

inter-process communication 


provide drill in number 
data in a machine-independent 


foackup 

foackup make a 

procedure checkall 
generate an |OT 

backup of a file system 
backup of a file system 
close or flush a stream 

file control options 

stream status inquiries 
and statistics for a file system 
Cut out selected 

times utime set 

common object 

determine accessibility of a 
tape 

copy 

password/group 

change of of 

change owner and group of a 
differential 
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execute commands at a later time ........ at(1) 
execute regular expression regcmo ....... regcmp(3X) 
execute remote command requests ...... uuxqt(1m) 
execution COMMANS 0... ee L.cmds(4) 
EXECUTION CNV © sciisscesvasearsscacseecdbadecosreresadias env(1) 
execution for interval sleep .................... sleep(3C) 
execution profile Monitor... monitor(3C) 
execution time profile profil 0.0.00... profil(2) 
OXECUTION UK vesiccacncrercniteseatraierteamnaavenn uux(1) 
exercise link and unlink system ............. link(1m) 
EXISTING ONE Creat oe cece creat(2) 
exit terminate Process ......... ees exit(2s) 
ONE crete itor aiaess eat nauens cack deneansaaaee exit(2) 
OXHS: AWHILG asainciiatesietlosiacneeniugeTndvecarelsauiees write(1) 
ONO OMAN iste acctseendtctassenbtemnndutmazee exp(3F) 
exp exponential, logarithm, 0... exp(3M) 
expand fileS Pack 0... ceeeeeees pack(1) 
explicit Fortran type 00.0... eee cence ftype(3F) 
exponential intrinsic function ................. exp(3F) 
exponential, logarithm, power, ............... exp(3M) 
EXP EVAIUATE oc ceecccstceeteceeeeeeees expr(1) 
expression compile and match ............... regexp(5) 
expression compile regcomp ........... regcmp(1) 
EXPFESSION EXP oo. eee cceneetteerteeeeeees expr(1) 
EXPFESSION FEGCMP ou... cc ccscee eerie regcomp(3X) 
extract error records from dump ............ errdead(im) 
EAT «tic areaecat ennen ava transected ea ieee arte 77(1) 
f77, ratfor, or efl files fsplit 0.0, fsplit(1) 
facilities status ipcs report uu... ipcs(1) 
factor a number factor oo... eee factor(1) 
factS AFithMetic oo... ceteeees arithmetic(6) 
fashion. sput! long integer .......0........08 sputi(3X) 
fast incremental backup fine 0.0.0... finc(1m) 
fast main memory allocator malloc ........ mailloc(3X) 
fast tape backup of a file system ........... foackup 
fast tape backup of a file system ........... fbackup(8) 
faster file system checking .............0.. checkall(1m) 
TAU AD OIE Se sincecesaccsieteaanctenaeteendate: ‘.. abort(3C) 
fbackup make a fast tape oe fbackup(1m) 
fbackup make a fast tape on... foackup(8) 
1ClOSO ertitecravislartneadmcneiesatneen aun fclose(3S) 
TOMAR: ncctsach Stsunensdaeg hernotiebedeheita ous Gat nantes fentl(5) 
(Cl co] gee Eee Reem tre ee oon ean ferror(3S) 
ff list file NAMES ooo ee tte tees ff(1m) 
fields of each line of a file cut .............. cut(1) 
file access and modification .........0..0.... utime(2) 
file access routines Idfcn wo. Idfen(4) 
THO ACCESS tas di Garey dherctia tae mieeearticniny access(2) 
FIG APCHIVER tal oo... ececececeeeseeseecaeeeeeees tar(1) 
file archives in and out cpio .............06. cpio(1) 
fille CHECKErS PWCK eect eeeeeen pwek(1m) 
THE CHM OG: sccie nsncrveriecccerccnteceesnaciatecnns chmod(2) 
TE GHOWE: sissduazeviseircosmretame Sociereceerada chown(2) 
fille comparator diff... eee eereees Giff(1) 
file COMpArISON GiffS oe eee diff3(1) 
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set and get 
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selected fields of each line of a 
convert and copy a 
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close a 

duplicate an open 
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close close a 

dump selected parts of an object 
print current SCCS 

get group 

get password 

access utmp 

write password 

execute a 

search a 

open a common object 
per-process accounting 

common archive 

error-log 

number entries of a common object 
get a version of a SCCS 

group 

files filendr 

file Idfhread read the 

file seek to the optional 

split a 

issue identification 

header of a member of an archive 
close a common object 

file header of a common object 
of a section of a common object 
file header of a common object 
of a section of a common object 
section header of a common object 
‘section of a common object 
table entry of a common object 
table entry of a common object 
symbol table of a common object 
number entries in a common object 
link to a 

build special 

or a special or ordinary 

generate 

make a unique 

file system ff list 

change the format of a text 

print name list of common object 
the null 
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TE CONMOIICINN: se scstomncicuassounteceueen aes fentl(2) 
file control options fentl oa, fentl(5) 
THE CODY UNO: od cursarterewarteuitedtarais uuto(1) 
TG COlC. a sii ha ee eereier sa piti attracted core(4) 
file creation mask uM@aSK 1.0... umask(2) 
file creation MASK .............cc ccc cece umask(2s) 
FO CHROMA. + eseeieeetde cesar deat eennsiecaylactenceeas crontab(1) 
NIERCUL COU OUL xox. curauiieritaadeackeserin cut(1) 
THOSOO. rinse sisrteeoncitiauea dt inccta tar cadets dd(1) 
HBOS a icisccutsxtinaiien inns uaincashUandeoatenties delta(1) 
file descriptor ClOSE o.oo... eens close(2) 
file descriptor GUD... eccceeccteeenees dup(2) 
file descriptor is a isatty oe isatty(2s) 
fE GESCrIPION oe eeeerterteeeeeeee close(2s) 
file dump wu... ere Se eee errr dump(1) 
file editing activity Sacto... ee sact(1) 
file entry getgrent 00... getgrent(3C) 
file entry getpWwent ............. eee getpwent(3C) 
file Entry Getut occ cece eneeeee getut(3C) 
file entry putpWeNt 0c putpwent(3C) 
FI OXEC oo. ccceeeeeeeeees i bseeateny oe Gaal exec(2) 
file for a pattern grep wwe grep(1) 
file for reading Idopen oo... ee Idopen(3X) 
THE TOR MAL ACCl Sutasudincoieienreeatetinnsatoaes acct(4) 
TE TOMM AP al :GicincrcininteneuAinnalelne ar(4) 
file format errfile .....0.. eens errfile(4) 
file function Idiread line .............0..8. Idiread(3X) 
THGGON wc fasssaricaitosiee poinittecn sess agiaereeeeten get(1) 
HIG: QROUD: *.cscecessuintin tty apuatuaschedeaceteamedare group(4) 
file header for common object ............... filendr(4) 
file header of a common object ............. I\dfnread(3X) 
tile header of a common object ............. Idohseek(3X) 
file into pieces Split 0... ees split(1) 
TE ISSUG one, Roti ceonliard eeancrenrenelcanuuanes issue(4) 
file Idahread read the archive ................ ldahread(3X) 
HO NOCIOSE ec icrGceete eh araeneonae Idclose(3X) 
file Idfhread read the .......... \dfhread(3X) 
file idiseek line number entries .............. \diseek(3X) | 
file Idohseek to the optional ......0...0000... Idohseek(3X) 
file Idrseek relocation entries ................. ldrseek(3X) 
file |dshread an indexed/named ............. Idshread(3X) 
file Idsseek an indexed/named .............. ldsseek(3X) 
file Idtbindex index of a symbol ............. \dtbindex(3X) 
file Idtbread an indexed symbol ............ ldtbread(3X) 
file Idtbseek seek to the ..... a, Idtbseek(3X) 
file INMENUM TINE oo... ee eeeeeeee linenum(4) 
NG WINK sscanteiaesaitereoransan diate seabeouetinentoen link(2) 
WS MKNOG scaseiigiisccrneearrweieccemacneoetcielans mknod(im) 
file mknod make a directory ................ mknod(2) 
file name for terminal ctermid .......0...00.... ctermid(3S) 
file NPaMe MKTEMP 00... eee mktemp(3C) 
file names and statistics fora 0.0... ff(1m) 
TIE MEWIONN nied accede aeemaasee newform(1) 
PHN OVAN seassecreyecusncachcalteaeccauacthctrehe wemente ene, nm{1) 
THEY GM ocisicn ions ae weetatdetvenumeanateineuaaibecancnte null(7) 
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common object 
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unmount a 

mount a 
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time dcopy copy 
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file of the current user ttyslot ...0......0000. ttyslot(3C) 

file or file structure fuser ............... eens fuser(1m) 

file or rewrite an existing one ................. creat(2) 

FIG PASSWA oo. ccceteeeeeeeseeeseeeeeeees passwd(4) 

file paste same lines of several ............. paste(1) 

file perusal filter for soft-copy ................ 9q(1) 

file pointer in a stream fseek .................. fseek(3S) 

fille pointer IS€@K oo... eeeeeeen lseek(2) 

TIS DONNTOR «terse t externas colataniakdins lseek(2s) 

file pointer tell 0.00... ec ce ec eetees tell(2s) 

TING PONS escices Agnes soa adtanteddetie caesar ieiaatt prs(1) 

THEO AD cnceydtircoectrsisuivdcasvabebuntgawsieis@ saashents read(2) 

file reloc relocation ...............cccc cece reloc(4) 

THESHINOG: Si acrivereeierecurananctnoeauaisees rmdel(1) 

file scanner bfS ............ ce eeeees bfs(1) 

TIE SCCSOIN case cusrcersersetrestainnenadiebdes: sccsdiff(1) 

MIG SCOSTIO (asi nieddacotladilaeeldsta sccsfile(4) 

file scnhdr S@CtION 0.0.0.0... eens scnhdr(4) 

Mle Status Stat. .ecsccuranasatnrabetetends stat(2) 

fil Status: envieaeceisdiiecie cians stat(2s) 

file strip and line number |... strip(1) 

file structure fuser identify .......0..0.00.00... tuser(1m) 

FIG SUM OFA scr. cccrtascatacuasan ti erventiosenatessiens sum(1) 

file symbol table entry ldgetname .......... Idgetname(3X) 

file symbol table format syms ................. syms(4) 

file system backup filesave |... filesave(1m) _ 

file system checking procedure .............. checkall(1m) 

file system consistency check and ........ fsck(1m) 

file system consistency check ................ fsck(8) 

file system debugger fsdb ............ fsdb(1im) 

file system debugger... fsdb(8) 

file system ff list oo... cece eeeeees ff(1m) 

file SYSTEM MEFS 0.0... tee ceceeeeeeees mkfs(1m) 

file SyStEM MOUNT ou... cer eteees mount(1m) 

file system MOUNT ou... eee mount(2) 

file system restore ........eee restor(im) 

fil€ SYSTEM FESTOTE 2.0.00... eee eeetseees restor(8) 

file system statistics uStat ...........0.0.00.. ustat(2) 

file system StatistiCS ......0..... eee ustat(2s) 

file system table mnttab .......000.. mnttab(4) 

file systeM UMOUNE oes umount(2) 

TG SYSIOMM: acceiseseesss sdusncs eset ened mesic mount(2s) 

TIE SVSTOM. fsiccs crs viaeericeatiautiatinialseaiecncnccess umount(2s) 

file system fOACKUP 0. es fobackup(1m) 

file systems for optimal access .............. dcopy(1m) 

file systems processed by fSck .............. checklist(4) 

file systems with label checking ............. volcopy(1m) 

TG TAN Scrcnetveeee each duanae asain tail(1) 

TIE TMONG east owen! tmpfile(3S) 

FIC TMPNAM ooo. cece ec ctceeeeeceeeteees tmpnam(3S) 

file touch update access .....0.. touch(1) 

file transport program for ...............c, uUCICO 

TIC APOC IW cases tec eras oases ftw(3C) 

TIE AV D0 TG oct se pesccunrtin ements file(1) 

TG UN GOL 35.5 sicedea carta cere tate Galette unget(1) 
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report repeated lines in a 

validate SCCS 

write on a 

creat create a new special 
determine file type 

mknod make a special 

read read from 

write on a 

and print process accounting 

set 

format of compiled term 

header for common object files 
merge or add total accounting 
create and administer SCCS 
concatenate and print 

compare two 

reject lines common to two sorted 
copy, link or move 

mark differences between 

file header for common object 
recover 

format specification in text 

split f77, ratfor, or ef 

string, format of graphical 

install object 

link editor for common object 
remove 

merge same lines of several 
compress and expand 

print 

of common object 
sort and/or merge 
identify SCCS 
archive format convert archive 
UNIX system file system backup 
file perusal 

select terminal 

line numbering 


section sizes 


graphical device routines and 
graphics 
fast incremental backup 


object library lorder 


the current user ttyslot 
find files 


ecvt convert 

manipulate parts of 

absolute value functions floor 
generate C 

close or 

open a stream 
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file uniq 
file val 


file 


file(s) acctcom search 
file-creation mode mask umask 


file. 


filendr file 
files acctmerg 
files admin 
files cat 
files cmp 
files comm select or 
files cp 
files diffmk 
files filendr 
files from a backup tape frec 
files fspec 
files fsplit 

files gps graphical primitive 
files in binary directories cpset 
files Id 
files or directories rm 
files or subsequent lines of one 
files pack 
files pr 
files size print 
files sort 

files what 
files 
filesave daily/weekly 
filter for soft-copy terminals pg 
filter greek 
filter ni 
filter reverse line-feeds col 
filters gdev 
filters tplot 


fine 
find 
find 
find 
find 
find 
find 


float and double routines 
floating-point number to string 
floating-point numbers frexp 
floor, ceiling, remainder, 
flow graph cflow 
flush a stream fclose 
fopen 
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hyphenated words hyphen 
name of a terminal ttyname 
ordering relation for an 
spelling errors spell 
the slot in the utmp file of 
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uniq(1) 
val(1) 
write(2) 
creat(2s) 
file(1) 
mknod(2s) 
read(2s) 
write(2s) 
acctcom(1) 
umask(1) 
term(4) 
filendr(4) 


acctmerg(1m) 


admin(1) 
cat(1) 
cmp(1) 
comm(1) 
cp(1) 
diffmk(1) 
filendr(4) 
frec(im) 
fspec(4) 
fsplit(1) 
gps(4) 
cpset(1m) 
Id(1) 


pr(1) 
sort(1) 


arcv(1) 


hyphen(1) 
ttyname(3C) 
lorder(1) 
spell(1) 
ttyslot(3C) 
find(1) 
float(2s) 
ecvt(3C) 
frexp(3S) 
floor(3M) 
cflow(1) 
fclose(3S) 
fopen(3S) 
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create a new process 
per-process accounting file 
common archive file 
common archive 

error-log file 

nroff or troff eqn 


i. a 
( a 
i. ie 


change the 


term 


graphical primitive string, 


nroft 

files fspec 

common object file symbol table 
tol 

sroff 

utmp and wtmp entry 

convert 

argument list vprintf print 

print 

| dformat disk 

mpt the macro package for 
troff text 

mm the MM macro package for 
OSDD adapter macro package for 
man macros for 

binary input/output 

recover files from a backup tape 
report number of 

parts of floating-point numbers 
format of system volume 

list of tile systems processed by 
check and interactive repair 
check and interactive repair 


file system debugger 

a file pointer in a stream 
specification in text files 
split £77, ratfor, or efl files 
controller 

walk a file tree 

explicit Fortran type conversion 
Fortran arcsine intrinsic 
Fortran arccosine intrinsic 
Fortran integer part intrinsic 
function erf error 

Fortran arctangert intrinsic 
Fortran arctangent intrinsic 
complex conjugate intrinsic 
hyperbolic cosine intrinsic 
precision product intrinsic 
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TOVK, sass'e Se nceate oacee Wanes eee a ee rasa: fork(2) 
TORT ALACCE fcc hiss Meaty es rent useaunennn: acct(4) 
TOMINACAG: So ccccerwer hanes cihde, eusetev ue eectataewn ar(4) 
format arcv archive files ........0.0.000000.0. arcv(1) 
TOFTMAL-CTNE ssxccsiceinty tedivencoraisuedoswenniae errfile(4) 


format mathematical text for ........00..... eqn(1) 


format of SCCS file sccsfile .........0.0.. sccsfile(4) 
format of a text file newform .................. newform(1) 
format of an i-node inode ................0.. inode(4) 


format of compiled term file. oe, term(4) 


format of core image file core .............. core(4) 
format of cpio archive cpio ou... cpio(4) 
format of directories dir oe dir(4) 
format of graphical files gps ...........0.0. gps(4) 
format of system volume fs ou... fs(4) 
format or typeset text ....... eee nroff(1) 
format specification in text ......... ee. fspec(4) 
TOFMAL-SVINS isose sss, oiiedeensinearauveniades: syms(4) 
format tables for nroff or troff ...........0.. tol(1) 
TORIMAL TOK os diccl tienastanh ate ieee trite sroff(1) 
TOPMALS UII Ps sirzidsicts Ger niatecearienemenataras: utmp(4) 
formatted input scanf ..........0...0.. seabed scanf(3S) 
formatted output of a varargs ..........0...... vprintf(3S) 
formatted output printf... wsuaee printf(3S) 


FOF MALEN .oooiecccccccccccsceseecesecssescscsees seseeeee dformat(8) 


formatting a permuted index ........000000. mptx(5) 
formatting and typesetting .......0...000000.. troff(1) 
formatting documentS ......... eee mm(5) 
formatting documents mosd the ............ mosd(5) 
formatting entries in this manual ............ man(5) 
TOO AG assist casas Bethe cc cteat at itty gira tis fread(3S) 
NEO sce eased: sseamesaeigmasseee hameaase frec(1m) 
free disk DIOCKS df oo... cceceeee seeeeeees df(1m) 
frexp Manipulate 0.0... cece eeeeeee frexp(3S) 


Gs Sr ea Sara ie ee fs(4) 


TSCK: CHOECKIISE cisctessstivcetd sosdvaiawsseicresier® checklist(4) 
fsck file system consistency ............... fsck(8) 
fsck file system consistency ..............4. fsck(1m) 
fsdb file system debugger .................8. fsdb(8) 
TSE? i cadccsiarewescanaerascreeesacendestasenaeeeend fsdb(1m) 
fs@@k rEpOSition oo... cee eeeteeees fseek(3S) 
TSEC TOMA saiciasseninsalseni vince aattasin fspec(4) 
SDI cance einenodias Gaaneerehnemataeareed: fsplit(1) 

ft IMSP streaming cartridge 0... ft(7) 

NW theese eens Sypset bree anne nein deniaee ftw(3C) 
NY PO. Gaia acentratienareieentes ftype(3F) 
[UNCIO SSIN scirstarssnariarnsamrevineiaiins sow @Sin(SP) 
function 4COS ou... er re acos(3F) 
TURCTON BING iG dasnieincier al sunonaial aint(3F) 
function and complementary error ......... erf(3M) 
VT ate (Co) gt: 1: (re atan(3F) 
FUNCTION ATAN] oo. ceetees oustouke atan2(3F) 
function conjg Fortran ou... eee conjg(3F) 
function cosh Fortran uu... cece cosh(3F) 
function dprod double ou... dprod(3F) 
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function and complementary error function erf error oo. erf(3M) | 
Fortran exponential intrinsic fUNCtION EXP... cette tes exp(3F) i 
logarithm, power, square root function exp exponential, 0.00.0. exp(3M) 
log gamma_ function gamma ............. ee gamma(3M) 
Euclidean distance function hypot 00.0.0. eeeeeeees hypot(3M) 
entries of a common object file function Idiread line number .................. l\diread(3X) 
natural logarithm intrinsic function log Fortran oo. log(3F) 
common logarithm intrinsic function log10 Fortran oe log10(3F) 
error-handling function matherr oo... ees matherr(3M) 
profile within a function prof oo... errr prof(5) 
transfer-of-sign intrinsic function sign Fortran... ee sign(3F) 
Fortran sine intrinsic fUNCtiON SIN ooo... cccceeteeeeeereeneeenes sin(3F) 
Fartran hyperbolic sine intrinsic function SIN oe ceeeeetteeeeteneees sinh(3F) 
Fortran square root intrinsic fUNCTION SQIT ow... cceeettteceecttttteees sqrt(3F) 
Fortran tangent intrinsic fUNCtion tan ooo... cececeteteeeesteeeeeees tan(3F) 
hyperbolic tangent intrinsic function tanh Fortran 0. ee tanh(3F) 
math functions and constants math ............... math(5) 
Fortran bitwise boolean functions DOO! 0.0... eeecseseeeessteseees bool(3F) 
Fortran cosine intrinsic fUNCTIONS COS oo... eccccctceeeteeesesstseees cos(3F) 
positive difference intrinsic fUNCtIONS GIM ow eeeeeeetes dim(3F) 
remainder, absolute value functions floor floor, ceiling, ...........0.0.. floor(3M) 
Fortran maximum-value fuNctiONS MAX oo... ce ccceesssteceeseeeeeeees max(3F) 
Fortran minimum-value functions MIN ooo... ccc tert min(3F) 
_ Fortran remaindering intrinsic functions MOd oe eeeteeerneee mod(3F) 
terminals 300 handle special functions of DASI 300 and 300s ............. 300(1) 
2621-series handle special functions of HP 2640 and ...... hp(1) 
terminal 450 handle special functions of the DASI 450 ..............., 450(1) j 
Fortran nearest integer functions round ........... ccc ceeeereeeeeees round(3F) eee 
hyperbolic FUNCTIONS SINN oo... eee eteenees sinh(3M) 
string comparision intrinsic functions StrCMP ooo... ee eects strcmp(3F) 
trigonometric FUNCTIONS triQ. ....... cc ccceetteeseeeeeees triq(3M) 
using a file or file structure fuser identify processes ...............0008. fuser(1m) 
QUESSING GAME MOO oo cceeeeeettereereeeertneens ... MOO(6) 
the game of backgammon back ...........0.... back(6) 
the game of black jack bj oo. bj(6) 
the game of craps crapS os craps(6) 
the game of hunt-the-wumpus wumo ........... wump(6) 
lOg Gamma FUNCTION GAMMA ou... cece e reece eetterereeeeees gamma(3M) 
device routines and filters gdev graphical oe gdev(1) 
GFADNIC GOMOl "GOO agit toat clay soseeledna eh ian Giviles. ged(1) 
tty general terminal interface 0.0, tty(7) 
generate C flow graph cflow |... cflow(1) 
cross-reference cxref generate C program ou... ee cxref(1) 
generate DES encryption crypt .............. crypt(3C) 
generate a maze mazZe ............ maze(6) 
generate an IOT fault abort 0... abort(3C) 
user ID diskusg diskusg generate disk accounting data by ......... diskusg(1m) 
generate encryption key makekey ......... makekey(1) 
ctermid generate file name for terminal .............. ctermid(3S) 
ncheck generate names from i-numbers ........... ncheck(1m) 
lexical tasks lex generate programs for simple ................ lex(1) 7 
pseudo-random numbers drand48 generate uniformly distributed ................ drand48(3C) ~ 
simple random-number generator rand ............ cece eeeetees rand(3C) 4 
random number generator rand oo... cere eres rand(3F) ci 
get a string from a stream gets .............. gets(3S) 
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get 


user cuserid 
stream getc 
nlist 


Stat 
ustat 
ustat 


uname 
vector getopt 
getpwent 


working directory getcwd 


getpid 
times 


parent process !Ds getpid 
and real and effective getuid 
real group, and effective group 


shmget 


gtty 
tty 


time 


Fortran command-line argument 
and get arguments for 

character or word from a stream 
of current working directory 
return value for environment name 
Fortran environment variable 

get group file entry 


get login name 


parse command options 
letter from argument vector 
read a password 


group, and parent process IDs 
get name from VID 

get password file entry 

get a string from a stream 
and terminal settings used by 


spawn 


terminal settings used by getty 
user, and real and effective 
group, and effective group ID's 
access utmp file entry 
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string, format of graphical files 


generate C flow 
draw a 
system activity 
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get a version of a SCCS file 0... get(1) 
get and set user limits ulimit ........00.000.. ulimit(2) 
get character login name of the ............. cuserid(3S) 
get character or word froma .............. getc(3S) 
get entries from name list .............0000. nlist(3C) 
get file status Stat 00. eeeeee stat(2) 
get fil€ StatUS 2... cc cceeceeeeenes stat(2s) 
get file system statistics 0.0.0... ustat(2) 
get file system statistics 0.0. ustat(2s) 
get group file entry getgrent ..........000.... getgrent(3C) 
get login name getlogin .......... ee. getlogin(3C) 
get login name logname ...............0...8. logname(1) 
get message queue msgget .............00... msgget(2) 
get name from UID getpw ................048. getpw(3C) 
get name of current UNIX system ......... uname(2) 
get option letter from argument .............. getopt(3C) 
get password file entry .......0...0.a. getpwent(3C) 
get path-name of current 00.0... getcwd(3C) 
GE PrOCESS 1D ssicivincxordies Paka Sensis: getpid(2s) 
get process and child process. ............... times(2) 
get process, process group, and ............ getpid(2) 
get real and effective user, ...........0000... getuid(2s) 
get real user, effective user, .................. getuid(2) 
get set of semaphores sem¢et ............... semget(2) 
get shared memory segment ................. shmget(2) 
get terminal characterisitcs ......0...00..00.. gtty(2s) 
get the name of the terminal ................. tty(1) 
GOt TIME TMS asnccciseteeriszincwissdanrtwerierans time(2) 
GOLWMNG: ssticccnci tanner msec! time(2s) 
getarc returm oo... cscs ee nee getarc(3F) 
getargv display a program name ........... getargv(2s) 
GEIC GC? ga ictavascnsheneeeonass getc(3S) 
getcwd get path-name ........... getcwd(3C) 
QEIOIV Wis ccatatcacti dats aehaceuamneienteeeece: getenv(3C) 
QELENV FOUN oo... ccecccccetesereetaeeees getenv(3F) 
GIGI ssccic deitiniaredianedticceemnicste. getgrent(3C) 
QGOGIN:. Gadiscechiwiniercns eninge getlogin(3C) 
[9 |=] (6] ©) GURU en RrnnT een Pent enn en One teen oe getopt(1) 
getopt get Option eee getopt(3C) 
GEIDASS fa hitechhc dc tinea hodenncticouahanaaeeites getpass(3C) 
getpid get process ID oe getpid(2s) 
getpid get process. process. .................. getpid(2) 
GOTO W ice asrencnap staan decsniespedtieastetatmeaees getpw(3C) 
QOD WEY earns estes ures cuca uasierareere ube setes getpwent(3C) 
GCIs ttt tetes rene seen irs gets(3S) 
getty gettydefs speed ....... gettydefs(4) 
getty to a remote terminal ct 0.0.0.0... ct(1) | 
gettydefs speed and oo... gettydefs(4) 
getuid get real and effective ........0..000.. getuid(2s) 
getuid effective user, real ...........0 getuid(2) 
GO ive wsiatetitete el caer en onaean getut(3C) 
gps graphical primitive 00... gps(4) 
GlAGN: CHOW scccsiteti tents eiseindenes cflow(1) 
OFADM Gla Ol sxcencctesoncarseceases tear neatteans graph(1) 
QUAD SAG sae cete sive ccna ccerpneen adie saq(1) 
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draw a graph 


graphics access 

Statistical network useful with 
filters gdev 

primitive string, format of 
routines toc 


plot 

graphical and numerical commands 
a macro package for making view 
select terminal filter 

search a file for a pattern 

set process 

user, and real and effective 

user, real group, and effective 
print user and 

set user and 

change owner or 

get 


log in to a new 

change owner and 

send a signal to a process or a 
group file 

real user, effective user, real 
getpid get process, process 
maintain, update, and regenerate 
characterisitcs 


graphical utilities 

300 and 300s terminals 300 
2640 and 2621-series terminals 
DASI 450 terminal 450 

varargs 

curses CRT screen 

guess the word 

run a command immune to 
manage 

scnhdr section 

filendr file 

ldfnread read the file 

seek to the optional file 

read an indexed/named section 
file Idahread read the archive 


ask for help 

HP 2640 and 2621-series terminals 
manage hash search tables 

the game of 

function cosh Fortran 
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greek 
grep 

group ID setpgrp 
group ID get real and effective 
group ID's getuid effective 
group IDs and names id 
group IDs setuid 
group chown 
group file entry getgrent 
group file group 
group newgrp 
group of a file chown 

group of processes kill 
group 
group, and effective group ID's 
group, and parent process IDs 
groups of programs make 
gtty get terminal 
guess the word hangman 
guessing game moo 
gutil 
handle special functions of DASI 
handle special functions of HP 
handle special functions of the 
handle variable argument list 
handling and optimization package 
hangman 
hangups and quits 
hash search tables hsearch 
header for a common object file 
header for common object files 
header of a common object file 


QIAN, ota a nap aie actoemennst 
graphic editor ged 
graphical and numerical commands 
graphical commands stat 
graphical device routines and 
graphical files gps graphical 
graphical table of contents 
graphical utilities gutil 
graphics filters tplot 
graphics interface plot 
graphics interface subroutines 
graphics access 
graphs mv 
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plot(3X) 
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format of core 

examine system 
argument aimag Fortran 
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hyperbolic sine intrinsic ............. cee sinh(3F) 
hyperbolic tangent intrinsic ............0.0.. tanh(3F) 
YOR ON? eukc cist honaeaecutianneeeamateeueees hyphen(1) 
VOOR scien tiie arene aan egns ee hypot(3M) 
MODOC CH iieseccictiteverncsarinaieugratGaelns clri(im) 
MODE INODE o.oo... ccc cece cece eeceeeeeeens inode(4) 
IPNUMDBELS NCHECK 0.00... ccc eeeeeeees ncheck(1m) 
JANOS AIG esse rotsccasnsstnetaeesi hie taseotaaiads iargc(3F) 
icp Intelligent Communications ............... icp(7) 
icpdmp dump contents of an ow... icpdmp(1m) 


id ipcrm remove a mesSage queue, ..... ipcrm(1) 
IG HOY cscetsre secaaiies aks ata adeveta anceeeateeancaene: id(1) 


identification file iSSUE oo... eee issue(4) 
identify SCCS files what oo... what(1) 
identify processes using a file ................ fuser(1m) 
IMAGE FIIE COPE ..... cc ceecceccccseneeeeeeeeeeeeees core(4) 
IMAGES -ChASN oa ianceiceneeseseasaemed eesti crash(1m) 
imaginary part of complex oe. aimag(3F) 


immune to hangups and quits nohup .... nohup(1) 
incremental backup fine «0.00... ee finc(1m) 
incremental dump tape format ................ dump(4) 


incremental file system restore .............. restor(1m) 
incremental file system restore .............. restor(8) 
independent operation routines .............. termlib(3c) 
index of a symbol table entry of ............ Idtbindex(3X) 
WAG OX POG ae iisca ast Seth ei sentenenlecs items ptx(1) 

index mpt the MaCro oo... ee mptx(5) 
WAGOX: TOMA: bi seica, sceceeiaamneedidcey antes index(3F) 


indexed symbol table entry of a ............. Idtbread(3X) 


indexed/named section header of ......... ldshread(3X) 
indexed/named section of a... Idsseek(3X) 
information for a common object ........... reloc(4) 
information from a common object ........ strip(1) 
information IpStat 0.0... ecceeereeeeeeees Ipstat(1) 

INit PFOCESS INMAD oes eceteteeee inittab(4) 


LIE aes niectasasventeavsusyy dina teabte-ccatassuentaacnweree? init(1m) 


iitialiZATION it ee ceeteeeeereeeeeeees init(1m) 
initialization shell scripts bre... orc(1m) 
initiate pipe to/from a process ..............0. popen(3s) 
WISTS ssdiielihee esta nd a deehiseiines dsedusicmidasebypees inittab(4) 
NOGG ra ficicha nee, oar eut naman a vantessanncaten inode(4) 
QUESCANE sic... psa tia saneedlnteatedarasd scanf(3S) 
input stream UNGELC oo... eee ungetc(3S) 


input/output fread oes fread(3S) 


input/output package Stdio we, stdio(3S) 
INQUITIES FELFOF oo... ccc ccccceecetteenesesseeees ferror(3S) 
inquiry and job contro! uustat 0... uustat(1) 
install object files in binary .........0..68 cpset(1m) 
WV SUAUE iiss ioia tose ate ad iercecnstolietiatratetanattens install(im) 
integer absolute value abs ........... abs(3C) 
integer and base-64 ASCII string ........... a64I(3C) 
INTEGEL Pata I A cess erereees sputl(3X) 
integer FUNCTIONS FOUNT oo... cece ereeeeees round(3F) 
integer part intrinsic function ...........08 aint(SF) 
integer Strtol ow. eee sles paetetcaneatase: strtol(3C) 
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convert between 3-byte: 


facilities status ipcs report 

system mailx 

file system consistency check and 
file system consistency check and 
error-logging 

graphics 

graphics 

controlling terminal 

pp parallel port 

tty general terminal 


characters asa 

SNOBOL 

tc troff output 

create an 

package stdipc standard 
suspend execution for an 
suspend execution for 
Fortran arcsine 

Fortran arccosine 

Fortran integer part 
Fortran arctangert 

Fortran arctangent 
Fortran complex conjugate 
Fortran hyperbolic cosine 
double precision product 
Fortran exponential 
Fortran natural logarithm 
Fortran common logarithm 
Fortran transfer-of-sign 
Fortran sine 

Fortran hyperbolic sine 
Fortran square root 
Fortran tangent 

Fortran hyperbolic tangent 
Fortran cosine 

positive difference 

Fortran remaindering 
string comparision 

control device 
configuration file 


integers and long integers (3tol .............. I3tol(3C) 
inter-process communication ............0. ipcs(1) 
interactive message processing ............. mailx(1) 
interactive repair fSCK oo. ees fsck(1m) 
interactive repair fSCK oo... ees fsck(8) 
INTE MACe Ol sass puernaernsicsuduiseosieta, err(7) 
ITCH ACE OlO8 sects nseocsvisarqantegueead. waadiiees plot(4) 
interface subroutines plot oo, plot(3X) 
(ALSACE MY: -cxcdicalusseveicesoisapaloevdamaersactecan tty(7) 
MOM ACO: acdsee sgceveus ttacnerieh mo tecanvierstateots pp(7) 
IPLGTIACE® aos canesevsamesmsacasnesninsereauasteaiints tty(7) 
interpolate smooth curve spline ............. spline(1) 
interpret ASA carriage control ................ asa(1) 
INTE IDPOlEl SNO> sisars econ sears eadee ea cnn sno(1) 


INTEL ONCION -.55c. andi eansa enw avumadin tc(1) 


interprocess channel pipe .............00000.., pipe(2) 
interprocess communication ........0.....0. stdipc(3C) 
Interval SIC@D ooo... eeeceeeeeeeeseeeeeeees sleep(1) 
INTELVAl SICBD: sccwyeles is epee naaeaeaniede sleep(3C) 
intrinsic fUNCTIO ASIN ........ cee ees asin(3F) 
intrinsic fUNCtION ACOS ee acos(3F) 
intrinsic function AINt ....... ee aint(3F) 
intrinsic function atan oe atan(3F) 
intrinsic function atan2 ........ ee atan2(3F) 
intrinsic function CONIG «0.0... conjg(3F) 
intrinsic function COSN ou... cosh(3F) 
intrinsic function dprod oo... dprod(3F) 
intrinsic FUNCTION EXP... ee exp(3F) 
intrinsic FUNCTION 10Q ...... ee eee eees log(3F) 
intrinsic function log10 oo... log10(3F) 
INtrINSIC FUNCTION SIQN oes sign(3F) 
intrinsic FUNCTION SIN ooo... ee ceeeeees sin(3F) 
intrinsic fUNCTION SINK oo... eee sinh(3F) 
INtrinSic FUNCTION SQ oo... eee ees sqrt(3F) 
intrinsic FUNCTION TAN ......... cee eee tan(3F) 
intrinsic fUNCTION tANh ....... eee tanh(3F) 


intrinsic FUNCTIONS COS ......... cece cos(3F) 


intrinsic fuNCtiONS GIM oo... eee dim(3F) 
intrinsic functions MOC ............cc eee mod(3F) 
intrinsic FUNCTIONS StrCMP oo... ees strcmp(3F) 
[oe ( Re enanecte tre ete este bee tere Earn creme nae iocti(2) 


ioctl syscon system console 


Pee cmwerarserosneve 


ioctl. syscon(4) 


semaphore set or shared memory id ipcrm remove a message queue. .......... ipcrm(1) 
communication facilities status ipcs report inter-process ..............ce. ipcs(1) 
specified file descriptor is a isatty returnsal if oe isatty(2s) 
Fortran system issue a shell command from ........... system(3F) 
issue a shell command system .............. system(3S) 
issue identification file issue .................. issue(4) 
issue identification file iSSUC oo... cee cceececetetteeeeeestne eeeeeeens issue(4) 
DrINt NEWS ITEMS NEWS occ cteeeeeteeceeeaeaees news(1) 
uucp status inquiry and job control uustat 0.0... eee uustat(1) 
relational database Operator fOIN occ cceeeeeeneteectteetntereeeeeeees join(1) a 
generate encryption key makekey 0.0.0... eee makekey(1)! 
kill all active processes killall 00.0.0... Killall(t4m) 7 
process or a group of processes _ kill send a Signal to a oo... ee kill(2s) 
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terminate a process 

a process or a group of processes 
kill all active processes 

test your 

3-byte integers and long integers 
copy file systems with 

pattern scanning and processing 
arbitrary-precision arithmetic 

the C 

command programming 

troff description of output 
execute commands at a 

editor for common object files 

of a member of an archive file 
close a common object file 
object file access routines 
header of a common object file 
object file symbol table entry 

of a common object file function 
a section of a common object file 
header of a common object file 
a common object file for reading 
a section of a common object file 
header of a common object file 
section of a common object file 
entry of a common object file 
entry of a common object file 
table of a common object file 
return length of Fortran string 
getopt get option 

generate programs for simple 
ordering relation for an object 
archives ar archive and 

bar Berkeley archive and 

get and set user 

establish an out-going terminal 
read one 

object file linenum 

object file manipulate 

of a common object seek to 
common object strip symbol and 
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cut out selected fields of each 
send/cancel requests to an LP 
read one line 
filter reverse 


entries in a common object file 
comm select or reject 

report repeated 

subsequent lines of merge same 
exercise 

information L-devices 

files Id 

common assembler and 


Plexus Sys 5.21 UNIX 


PERMUTED INDEX 


WINE sestinss Ae he Gi clean ech ays thats Slian eld ona wes kill(1) 

kill send a Signal to... es kill(2) 

RING rca tuccrndaictiiutatcle ditty A iansctena cat asaade killall(1m) 
KNOWlEdGE QUIZ ooo... ccc teeeeceeeeeees quiz(6) 

IStol convert between 0... eee I3tol(3C) 
label checking volcopy ou... volcopy(1m) 
IANQUAGE AWK oo... cette eeeeeeees awk(1) 
JANGUAGE! OC: accstnineiieeteretnveceendinaatis bc(1) 
language preprocessor Cpp ......... cpp(1) 
language sh standard/restricted ............ sh(1) 

IAN QUAG ES: ier teuseaineN ririueneaeaenatuctentias: troff(5) 

later TIME At oo... cece eeces sess eesea wees at(1) 

IG WAG: csc ccastiarncesttadatetes twactatseecteManadicuads Id(1) 
ldahread read the archive header ......... ldahread(3X) 
WOCIO SO artea rates nd asasernnetuc wena Idclose(3X) 
DIO COMMON cisiesavuccrescicsusntereeiasea tens Idfcn(4) 
ldfnread read the file 0.0... Idfnread(3X) 
ldgetname symbol name for common .. Idgetname(3X) 
Idlread line number entries ................... Idlread(3X) 
ldiseek line number entries of ............... Idiseek(3X) 
ldohseek to the optional file 0.0... Idohseek(3X) 
IDOPOM ODOM ciciakicneis scatman areca Idopen(3X) 
ldrseek to relocation entries of .............. Idrseek(3X) 
Idshread indexed/named section .......... Idshread(3X) 
Idsseek to an indexed/named ............... ldsseek(3X) 
Idtbindex of a symbol table 00.0... Idtbindex(3X) . 
ldtbread an indexed symbol table ......... l\dtbread(3X) 
Idtbseek seek to the symbol .......0....0.0.. Idtbseek(3X) 
ION caiscincnisedaacantitanasibsstakctiog, luwiansezntesni' len(3F) 
letter from argument vector .................5. getopt(3C) 
lexical taSkKS IOX oo. cccceeeeesseeeeeees lex(1) 

library lorder find oo... eeeeeeees lorder(1) 
library maintainer for portable ................. ar(1) 

library MaAINtaINEL ...... ccc e cee ee ees bar(1) 

TITS AMIS: Sicsacisarteredesdenchu aus Quataetlardhes ulimit(2) 

line connection dial .......0....c eee dial(3C) 

VIVO MUNG, Muses rieatanet ccamters eatgurieneracawonncenere’ line(1) 

line number entries in a common ........... linenum(4) 
line number entries of a common ........... ldiread(3X) 
line number entries of a section ............ Idlseek(3X) 
line number information from a ............. strip(1) 

line numbering filter nl owe ni(1) 

line of a file CUt 0 ceeceeeeee reas cut(1) 

ING PRINIEl ID: Avspaelertienisen inet dntires Ip(1) 

NASH hota tins ds tecbteae teers te ti eee tor terete Toes line(1) 
liNn@-fEEdS COL oo. eee cccceccecees es eeeeeeens col(1) 

linear search and update lsearch ........... lsearch(3C) 
linenum line number oo... eee linenum(4) 
lines common to two sorted files ........... comm(1) 
lines in a file UNIQ o.oo uniq(1) 

lines of several files OF ee paste(1) 

link and unlink system calls link ............. link(1m) 

link devices, connection ...............0c08 L-devices(4) 
link editor for common object ................ Id(1) 

link editor output a.out oe a.out(4) 


- 25 - November 1986 


PERMUTED INDEX 


copy, 
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link and unlink system cails 
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for a file system ff 

get entries from name 
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fsck checklist 

handle variable argument 
output of a varargs argument 
construct argument 

macref produce cross-reference 
index return 
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memory plock 


logarithm intrinsic function 
logarithm intrinsic function 
Fortran natural 

function exp exponential, 
process a report of 

configure 
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return 
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setting up an environment at 
setting up an environment at 
sign on 

get login name 

return login name of user 
relation for an object library 
run a command at 

requests to an LP line printer 
a the LP spooling system 
resume printing 

scheduler and move requests 
print LP status information 
directories 

list contents of directory 
linear search and update 
pointer 

move read/write file pointer 


macro processor 
access long integer data in a 


listing of macro files 
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link or Move fIIES CP ou... eeeeeeee cp(1) Y 
NAKSSVSIOINS scawcairwexesve Se tteuiccrnreratadtss L.sys(4) ‘ Z 
Tig) ae Co Be: We = (41 Greene ee link(2) . 
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INK CXC CISC: eis tisednearsaeeemisrneieenecorne el link(im) 

LA states clea aeouth nau neste eaten lint(1) 

list contents of directorieS ......... ee Is(8) 

list contents of directory Is .........00.. Is(1) 

list file names and Statistics .....00.000.8. ff(1m) 

SENSU cana ectons we bsteets cipiaidcon tee aces nlist(3C) 

list of common object file nm ow... nm(1) 

list of file systems processed by ............. checklist(4) 

NSU ValAtOS xacnitiswickinr Rut eaanacacaercs varargs(5) 

list vprintf print formatted oo... vprintf(3S) 

list(S) and execute command xargs ...... xargs(1) 

listing of Macro fil€S ees macref(1) 

location of Fortran substring .......0......8. index(3F) 
locations in program end ..............c06. end(3C) 

lock process, text, or data in oe, plock(2) 

log gamma function gamma .............08. gamma(3M) 


log in to a new group newg@grp ................ newarp(1) 


log Fortran natural .00.... eee log(3F) 
log10 Fortran common... eee log10(3F) 
logarithm intrinsic function log ................ log(3F) | 
logarithm, power, square root ............... exp(3M) 
logged errors CFrpt eee ree errpt(1m) 


IOGICA CISKS reese Sedalia cence dconfig(1m) 
login name GetlOgGin 0... eee getlogin(3C). 


login name logname ....... ee logname(1) 
login name of the user cuserid .............. cuserid(3S) 
login name of user logname ................. logname(3X) 
login password PaSSWG .......... eee passwd(1) 
login time profile oes Profile(4) 
login time Profile oo... cece eeeeeeenes profile(5) 
TOGUID pesca stetteacaxciy erick ccviouliee tau eeousueseistarauens login(1) 

OOM AM © acccatseshievtan estore dea nicenatnyanonecsettene logname(1) 
OGM AING: cesaciececiclicnunanvesvstiaatcncnneseapidtgeanrains logname(3X) 
lorder find Ordering ..........cccc eee lorder(1) 

OW PFiOTitY NICE cece cceee reat eeeee nice(1) 

ID SONG/CANCE! oicccdrincerinranactactns Ip(1) 
IDACMIM:.isaidnay, Gucstuvnaseeaniinntieeseteadions lpadmin(1m) 
Iphoid postpone printing, .... ee Iphold(1) 
Ipsched the LP request ....... ee lpsched(1m) 
IOS tal oid ans rte eerie amnaeeas piers Ipstat(1) 

Is list CONTENTS Of eect eeeeneees ls(8) 

1S. al acaamnasineden toate tyincs baavaaaaneaie scenes atinete is(1) 

IS@AICN « Giaieuisona ietinceced cama iewc esac lsearch(3C) 
lseek move read/write file oo... lseek(2s) 
ISGCK sii uscornsciean rere tediensiesreinaierermerats lseek(2) 

Ist locations in program end ........ end(3C) 

PUA atid tiduahante cucatiah etalon ech onan: m4(1) 
machine-dependent values values ........ values(5) ye. 
machine-independent fashion. ............... sputl(3X) ‘ 


oe macref(1) \_/ 


macref produce cross-reference ............ macref(1) \___ 
basutielges mptx(5) 


macro package for formatting a 
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documents mm the MM_ macro package for formatting ................ mm (5) 
mosd the OSDD adapter macro package for formatting ................ mosd(5) 
graphs mv a_ macro package for making view ............ mv(7) 
viewgraphs and mv a troff macro package for typesetting ............... mv(5) 
macro processor M4... eee m4(1) 
in this manual man macros for formatting entries ................. man(5) 
send mail to users or read mail mail ............... mail(1) 
binary file for transmission via mail encode/decode a... uuencode(1c) 
message processing system mailx interactive oo... ee mailx(1) 
main memory allocator malloc ............... malloc(3C) 
fast main memory allocator malloc ............... malloc(3X) 
regenerate groups of programs maintain, update, and ........ ee make(1) 
ar archive and library maintainer for portable archives ............. ar(1) 
SCCS file delta) make a delta (change) to an ........ a. delta(1) 
make a directory mkdir... ee mkdir(1) 
or ordinary file mknod make a directory or a special ................. mknod(2) 
mknod make a special file 0... mknod(2s) 
make a unique file name mktemp ......... mktemp(3C) 
make posters Danner oo... eee ees banner(1) 
generate encryption key Makekey oo... cecceseteeteeceeeeeeees makekey(1) 
mv a macro package for making view graphs ............ eee mv(7) 
main memory allocator mMallOC ..........cccccccccesccscesesseesseesteessseeeeens malloc(3C) 
fast main memory allocator MallOC 0... ceneeeeeeetteeeenaeees malloc(3X) 
tsearch manage binary search trees .................. tsearch(3C) 
manage hash search tables hsearch .... hsearch(3C) 
a common object file function manipulate line number entries of .......... Idiread(3X) 
= floating-point numbers frexp manipulate parts of 00... ees frexp(3S) 
( ; print entries in this manual MAN occ eee eeees man(1) 
p map of ASCII character set ascii ........... ascii(5) 
diffmk mark differences between files .............. diffmk(1) 
set file-creation mode mask UMASK 0.0.0.0... cece ceeteeees umask(1) 
set and get file creation maSk UMASK 0... eee eee umask(2) 
set and get file creation mask UMASK 0.00.0... ceeeteecceeeeeees umask(2s) 
regular expression compile and match routines regexp ............... regexp(5) 
math functions and constantS Math 0... ccceseettetteeeesetnreaeenaies math(5) 
error-handling function mMatheri occ cette eeneaeeeeee matherr(3M) 
Fortran maximum-value€ fUNCtIONS MAX oo... ccc cceseeseetstttttetseseeeeeeereeeeenees max(3F) 
Fortran maximum-value functions max ............. max(3F) 
Generate 2 MAZE MAZE oun... ec cettee eter een eeeeey maze(6) 
return Fortran time ACCOUNTING MCI]OCK oo... ccc cena settectteeseeaaeees mclock(3F) 
modem mdial dial the P/75 onboard .............0.... dial(1) 
COTE MOMOSY MOM oo. ccctettneresneeneeeeeeseeesenteneeeces mem(7) 
read the archive header of a member of an archive file ..............0...... Idahread(3X) 
main memory allocator malloc ..........0.....000. malloc(3C) 
fast main memory allocator malloc ........ malloc(3X) 
ramdisk memory aS diSkK oo eee erie ramdisk(1m) 
shared memory control operations shmctl ......... shmcti(2) 
queue, semaphore set or shared memory id ipcrm remove a message ... ipcrm(1) 
COFE MEMOTY MOM oo... ccccccecetteeetteereenees mem(7) 
memory operations memory ..............6 memory(3C) 
shared memory operations shmop ................... shmop(2) 
| lock process, text, or data in MeMOTY PIOCK 00... cece eee eee plock(2) 
ie get shared memory segment shm¢et ..........0.ccc shmget(2) 
a. rram allows memory to be used as a disk 0... rram(7) 
= MEMOTry OperatioNS MEMOLY .......ccccccccccceteesetsetetetensteeteees memory(3C) 
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sort and/or merge files Sort 0. ec eeeeeeee sort(1) 
files acctmerg merge or add total accounting ............... acctmerg(1m), 
or subsequent lines of one merge same lines of several files ........... paste(1) 
permit or deny MESSAGES. MES oo. ccc eereteeceteteraeeraee mesg(1) 
msgctl message control operations ............0... msgctl(2) 
message operations msgop ................... msgop(2) 
interactive message processing system mailx ........ mailx(1) 
get message queue msgget ............... ee. msgget(2) 
shared memory id remove a message queue, semaphore set or ....... iperm(1) 
permit or deny Me€SSAGES MES ....... eee ceeetee ees mesg(1) 
System error MESSAGES PEFOF ooo... ects eeeee perror(3C) 
Fortran minimum-value fUNCTIONS MIN oo... cc cceccecesccsecneeteetsaaceesneenes min(3F) 
two identical mirutil utility for connecting 0.0.00... mirutil(1m) 
overview of accounting and miscellaneous accounting commands ... acct(1m) 
Make a directory MKF oe cccccceceeeeceeeceeeeese eeeaaaes mkdir(1) 
mkfs construct a file system oo... mkfs(8) 
construct a file systeM MKS oo... ccceeeeceececeesetaaaseeeeeeens mkfs(1m) 
mknod make a Special file... mknod(2s) 
build special file MKNOd oo... ccc ceetceeccesetseeeseenaesessaeens mknod(im) 
or a special or ordinary file mknod make a directory 0... mknod(2) 
make a unique file NAME MKTEMP oo... ccecttcerteseeteee seeeeees mktemp(3C) 
formatted with the MM macros mm printcheck documents .................... mm(1) 
formatting documents mm the MM macro package for ............. mm(5) 
document compatibility checker mmlint sroff/MM nroff/MM uo... mmiint(1) 
viewgraphs, and slides mmt typeset documents, .......... mmt(1) 
mounted file system table Mnttad occ ecentee center eeseeeens mnttab(4) 
remaindering intrinsic functions MOd Fortran... cette mod(3F) 
change mode chmod... ese eeeeeee chmod(1) | 
set file-creation mode mask UMASK 0.0... ccc umask(1)  \. / 
chmod change mode of file 0... cc ccectteeeeees chmod(2s) 
dial a Racal-Vadic 3451 modem 00... ccceeetettteeee essere dial(1) 
mdial dial the P/75 onboard MOdeM oo... ees ceteeeeeeteeeereaeeeneas dial(1) 
a compiler/interpreter for modest-sized programs Ds ..............08. bs(1) 
touch update access and modification times ofa file 0... touch(1) 
set file access and modification times utime .........0..0000. utime(2) 
monitor uucp network uusuD «2.0... uusub(1m) 
prepare Execution profile MOMITOE oo. ccc eneeneeeteeeteeteeneees monitor(3C) 
QUESSING GAME MOO oe ececccnceeteeeeeeeteeteteesnsertseeteeeae moo(6) 
package for formatting documents mosd the OSDOD adapter macro ............ mosd(5) 
mount mounta file system 0.0... mount(2s) 
mount mount and dismount file system ............ mount(1m) 
| establish mount table setMnt 00.0... ees setmnt(1m) 
mount and dismount file system MOUNT ooo. cere reeetteeecnteeeeaey mount(1m) 
mount a file SySteM MOUNT oo. rttetteesetereeeeeaes mount(2) 
mnttab mounted file system table... mnttab(4) 
move a directory MVGIP oo... ee eee mvdir(im) 
copy, link or move fileS CO oo. eeeteees cp(1) 
iseek move read/write file pointer oe. iseek(2) 
lseek move read/write file pointer ....0..... lseek(2s) 
the LP request scheduler and move requests Ipsched start/stop .......... lpsched(1m) 
formatting a permuted index mptx the macro package for .................. mptx(5) 
message control operationS MSQCt ot eererertreenieeees msqgcti(2) 
get Message QUEUE MSGGEt occ ceeteteeeeteeeertaees msgget(2) ~~ 
MESSAGE OPeratiONS MSQOP oo... ccccccccctceceesseetteeeteneeee msgop(2) ‘ 
view graphs mv a macro package for making ........... mv(7) : 
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mv a troff macro package for ................. mv(5) 

FPL VGIP cir cssncsGiean these tea steatanteanintogmunrcusaat boar mvdir(1m) 
NAMES CEVA: arcsuoddisls ciswacsntareeieas: devnm(1m) 
name for a temporary file tmpnam ......... tmpnam(3S) 
name for common object file ................. Idgetname(3X) 
name for terminal ctermid .............0...005. ctermid(3S) 
name from UID getow oo. getpw(3C) 
NAME GetENV o.oo... cceececeeee rr getenv(3C) 
Mame getlOgin oo... ee getlogin(3C) 


Name: liSt MiSt ssc ste ests oes eieGecortens nlist(3C) 
name list of common object file ............. nm(1) 
Name lOGNAME 2... cee ee etees logname(1) 
MAME MKTEMP ooo... cee eccecee eeteeees mktemp(3C) 


name of a terminal ttyname ......... ieiccem, ttyname(3C) 
name of current UNIX system ................ uname(1) 
name of current UNIX system ................ uname(2) 


name of the terminal tty 0.0... tty(1) 


name of the user cuserid 0.0.00... cuserid(3S) 
name of user logname  ........ ee logname(3X) 
MAMO DWC: secre acta. an keanenanuetetucmaatinn pwd(1) 
names and statistics for a file... ff(1m) 
NaMeS DASENAME 00... eee basename(1) 
names for terminals term .........0....0.00 term(5) 
names from i-numbers ncheck .............. ncheck(1m) 
MAMeS: IC: st exsist nein id(1) 
natural logarithm intrinsic .............. ead log(3F) 
PICHIOCK: cocepntscssdsnieomne state datisisieasticans ncheck(1m) 
nearest integer functions round ............. round(3F) 
neqn eqnchar speCial ..0......... ccc ceeeees eqnchar(5) 
Net EXCCUIC  catsisicctianiastaiicanweon tees net(1) 
ROTWOTK NOL 25s sons ssatascescareratantanten dane net(1) 
network useful with graphical ................ stat(1) 
network UUSUD oo... eee eeeeeeeee uusub(1m) 
NEWIONN Ssorsescceuiinsedelas newform(1) 
NOWOND: oo istics een enetansoateh eurenens newarp(1) 
NEWS ITEMS NEWS oo... eects news(1) 
nice change priority of a ow... nice(2s) 
ICO sai eh isctase Seen iceg ler ieisrennt ney tance tas nice(1) 

NGG ws cccrcastioreaceuercenae alee oie nice(2) 

UMN Sa cates etrsncistsyaa aut was eeu nee paus esa aa benoit ni(1) 

PINS Tie ce cedar tecteot vers dal eam, nlist(3C) 
PIQUCSDMING etraseeslsdeassancstntentecptre leone cacraeteagent nm(1) 
nohup run acommand ....... nohup(1) 
nroff documents for the Xerox ............... x9700(1) 
nroff format or typeset text 0... a. nroff(1) 
PLOROP POM 210, sicisicacntednaonecle octane tol(1) 
nroff/MM document compatibility ............ mmiint(1) 
nroffftroff, tol, and eqn oo... eee deroff(1) 
UE THO AMIE cs cs tren tees nedeaia ce debaoadrthendariancts null{7) 


number entries in a common object ...... linenum(4) 
number entries of a common object ...... Idlread(3X) 


number entries of a section of a ............ Idiseek(3X) 
Number factOr 0... eceeceeeeeeeeerenteteees factor(1) 
number facts arithmetic .......00..0.. cc. arithmetic(6) 
number generator rand 00... eee rand(3F) 
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object strip symbol and line number info from a common .................. -strip(1) 
| report number of free disk blocks df ................. df(1m) 
string to double-precision number strtod convert ......00e, Sstrtod(3C) 
convert floating-point number to string eCVt oo... ee ecvt(3C) 
line numbering filter nt oe eeeees ni(1) 
distributed pseudo-random numbers drand48 uniformly .........00.000. drand48(3C) 
parts of floating-point numbers frexp manipulate .................... frexp(3S) 
access graphical and numerical commands graphics .............. graphics(1) 
common object file access routines Idfcn ............. Idfcn(4) 
dump selected parts of an object file dUMP oo... etree dump(1) 
open acommon_ object file for reading Idopen .................. Idopen(3X) 
line number entries of acommon object file function Idlread ..............00..... Idiread(3X) 
close acommon object file Idclose oo... ee ceeeeeees Idclose(3X) 
read the file header of acommon_ object file Idfhread 0.0... er Idfhread(3X) 
entries of a section of acorimon object file Idlseek line number ............... Idiseek(3X) 
optional file header of acommon object file Idohseek seek to the ............. Idohseek(3X) 
entries of a section of acommon object file Idrseek relocation .................. Idrseek(3X) 
section header of acommon object file Idshread oes Idshread(3X) 
section of acommon object file Idsseek ...........0... ldsseek(3X) 
a symbol table entry of acommon_ object file Idtbindex index of .............0.. ldtbindex(3X) 
symbol table entry of acommon object file Idtbread an indexed .............. Idtbread(3X) 
to the symbol table of acommon_ object file idtbseek seek 0.0... \dtbseek(3X) 
line number entries in a common object file linenuM ooo... eee linenum(4) 
print name list of common object file NM cette eeeees nm(1) 
information fora common object file reloc relocation ..................0.. reloc(4) 
section header fora common object file Scnhdr oo... eee scnhdr(4) 
number information from acommon_ object file strip and line... seictuaat strip(1) | 
retrieve symbol name for common object file symbol table entry ................. Idgetname(3,__ 
syms common object file symbol table format ..... acess syms(4) . 
file header for common object files filendr oo... cee eeeees filendr(4) 
directories cpset install object files in binary 0.0... ee cpset(im) 
link editor for common object fil€S Ido. ccceesssetrree eres Id(1) 
print section sizes of common object fil€S SIZ@ ow. cetceerte eaters size(1) 
find ordering relation for an object library lorder 0... eeeeee lorder(1) 
Od): OCA QUIN: cist ecieiatteclatunantansnsous od(8) 
text for otroff ocw prepare constant-width «00.0... ocw(1) 
OG OCtAl CUM wees idessincrncarawrentegndancciees od(8) 
OCTAV CUM 200 isn Sir pessmescccesedndeos alot onweRseniadiaecds od(1) 
mdial dial the P/75 onboard Modem ........ cc cccceseceeeneeeee dial(1) 
reading Idopen open a common object file for 0.0.0... idopen(3X) 
Open a Stream fOPEN oo... cece fopen(3S) 
duplicate an open file descriptor dup ooo... dup(2) 
open open for reading or writing .......... open(2) 
open open for reading or writing ..........0....6. open(2s) 
open for reading OF WitING OPEN occ teeetectteeecttaeeseerenns open(2) 
profiler operating system profiler oo... profiler(1m) 
terminal independent operation routineS 0... cece termlib(3c) 
memory operations MEMOry occ memory(3C) 
message control operations msgctl eee msgcti(2) 
message operations MSQOP ........ ee msgop(2) 
semaphore control operations SeMCctl oes semctl(2) 
semaphore operations SEMOP ..0... eee semop(2) 
shared memory control operations ShMctl ou. ee shmectl(2) : 
shared memory operations SNMOP ....... eee shmop(2) 
String operations String ....0.. eee string(3C) 
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OPEVAlOl (ONY ee sess cincteautaavenisesannictenser join(1) 
optimal access time dcopy .................0. dcopy(1m) 
optimization package Curses .............. curses(3X) 
option letter from argument ................0. getopt(3C) 
optional file header of a common .......... Idohseek(3X) 
OPtiOns:1CAN ccGcradlnn teow fenti(S) 
options for a terminal stty ..........0... stty(1) 
Options getopt .............. cesses cnet getopt(1) 
ordering relation for an object ................ lorder(1) 
ordinary file MKNOd o.oo... tee eeees mknod(2) 
OUON, COW ibs Giseciccsig ae ndetenmadiarinnsiees ocw(1) 
out-going terminal line ............ dial(3C) 
OUIDUT 2. GUE is erkiek etd lcnn einen: a.out(4) 
Output interpreter ......... eee tc(1) 

Output lANQUAGE ou... eee eee e tees troff(5) 
output of a varargs argument list ........... vprintf(3S) 
QUIOUT DONT ic. ents ccsnthe atest daar, printf(3S) 
overview of accounting and .................. acct(1m) 
owner and group of a file chown ........... chown(2) 
owner Or group CNOWN .......... eee chown(1) 
DCM stat ciccire ye Vinandee eur eeanahennemawoeanion: pack(1) 
package curses CRT ou... cceceeeee curses(3X) 
package for making view graphs ........... mv(7) 

ef: Tol ¢: lo (--y- | re sar(1m) 
PACKAGE: SIGIO’ 22s eca Nahe id nruncwuepectvaies stdio(3S) 
package Stdipc standard ....... ee. stdipc(3C) 
paginator for the TEKTRONIX ................ 4014(1) 
parallel port interface oo... cee pp(7) 

parent process IDs getpid 0... getpid(2) 
parse command options getopt .............. getopt(1) 
part intrinsic function aint ........... aint(3F) 

part of a file tail oo... eeeseeeeeees tail(1) 

part of complex argument aimag ........... aimag(3F) 
parts of an object file dump ......... a, dump(1) 
parts of floating-point numbers ............... frexp(3S) 
DASSWO iecsnidctercescmjsieieedncecoarenaraanean passwd(1) 
DASSWO) eiiric etal csavacesearesineranionanmne, passwd(4) 
password file entry getpwent ........0..0.. getpwent(3C) 
password file entry putpwent 0.0.0.0... putpwent(3C) 
password file paSSWd oo... eee passwd(4) 
PASSWOrd GEtPASS ores getpass(3C) 
PASSWO'd PASSWA ou... ee eres passwd(1) 
password/group file checkers ............... pwek(1m) 
paste lines of several files paste(1) 
path names basename .......... ee basename(1) 
path-name of current working ............... getcwd(3C) 
pathname permissions file ..............0008 USERFILE(4) 
DENOM Gl60 dein tise nonmangataetn grep(1) 
pattern scanning and processing ........... awk(1) 
DAUSC icici ni dedataaberetacs ines ieeattentus ces inass pause(2) 
per-process accounting file 00... acct(4) 
per-process accounting records ............. acctcms(1m) 
DEFMISSIONS FIO eect ereenees USERFILE(4) 
permit or deny messages mesg ............ mesg(1) 
permuted INdOX PK oo... cere eeen ptx(1) 
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print/check documents formatted ........... mm(1) 
printer Ip send/cancel «0... ee Ip(1) 
printer prepare nroff oe eee x9700(1) 
printer prepare troff 0... eee dx9700(1) 
DrINterS ENADle occ cee cette tees enable(1) 
OUIGUE siatssursurtacicac gs det eauas ba eientunranbhe sae printf(3S) 
MINT: son cicttaentecnte tatarentaatn Cceawnnsars a ancaunnttens Iphold(1) 
prioritize print QUEUE oo. ees topq(1m) 
BROTIIY NICE ci. s5. cereal adic staednacmeeny nice(1) 
priority of a process NICeé ............ ee nice(2) 
priority Of A ProCeSS ooo... eee nice(2s) 
procedure checkall ......... cece checkall(1m) 
DIOCESS: Diets hacia hates getpid(2s) 
process IDs getpid get process, ............ getpid(2) 
process a report of logged errors ......... errpt(1m) 
process a report of logged ............ eae errpt(1m) 


process accounting acct ............ ee acct(2) 


process accounting file(S) .......0.......000. acctcom(1) 
process alarm clock alarm ............ seesleaiaic alarm (2) 
process and child process times ............ times(2) 
process control initialization ..........0..0000... init(1m) 


process data and system activity .......... timex(1) 
DIOCOSS) Cx ceca einahersnydaduerarnecingeuarenatan exit(2) 
ROCESS! OMG ircsinc ni hcncandoranniadepnnsane deren fork(2) 
process group ID setpgrp 0... setpgrp(2) 


process group, and parent process ........ getpid(2) 
PFOCESS INMMTAD oe ceneeerteeeeeens inittab(4) 
process kill ....... Fa cautenestseadite ata ae ema uaa kill(1) 
DIOCESS ICE: 4.20) cin mane ceeneneeteenants nice(2) 
process or a group of processes. ........... kill(2) 
DIOCESS DODEN) giro naam icisanierniecosnnns popen(3S) 
DrOCeSS SlalUS0S <.cauicedauenn ps(1) 
PYOCESS TIMES: cisco ct anaiesensnaaauers times(2) 


process to stop or terminate wait ........... wait(2) 


process trace ptrace oo... ee ptrace(2) 
process until signal pause |... pause(2) 
PIOCESS Wall ciuincouiscceatiencein nies wait(1) 
DICCESS® scuncond.nvesManeareiee decrees exit(2s) 
DIOCESS: iaseyteenctlhaten tn chien tea taetinea tes nice(2s) 
process, process group, and ....... getpid(2) 
process, text, or data in memory, ............ plock(2) 
processed by fsck checklist ......0.0.00.00.0. checklist(4) 
processes kill Send @ ........ccccc ccc kill(2) 
processes killall 00.000. eee eeeeeeeee killall(1m) 
processes using a file or file 0... fuser(1m) 
processing language aWK ............ awk(1) 
processing shutdown ............. eee shutdown(1m) 
processing system mailx oo... mailx(1) 
DIOCESSON INS ia) cranes tesa tse Cras tench eendtteer m4(1) 
product intrinsic function dprod ............. dprod(3F) 
EOI occa ak oyhuscstessopiensans neueeetea Seah aqbe naan mrentanaane prof(1) 
EOE iets aes CA ie tee vances insecan tania prof(5) 
DIONE Sepsecrrcasvse ecsen nays atacamainee Zaaate: profil(2) 
profile data prof .......... ec ceceneteeeees prof(1) 
DIOS: MONNOR sac tccrott chee etter. monitor(3C) 
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execution time 
environment at login time 


up an environment at login time 
disk access 

operating system profiler 
terminate Fortran 

verify 

C 

aC 

generate C 

Cc 

ist locations in 

for getargv display a 
side-by-side difference 
conversion 

the standard/restricted command 
for modest-sized 

lex generate 

update, and regenerate groups of 
arithmetic 


print an SCCS file 
report process status 
generate uniformly distributed 


process trace 
permuted index 
copy uuto 
stream ungetc 


stream putc 

or add value to environment 
write password file entry 

put a string on a stream 
password/group file checkers 
working directory name 
quicker sort 


get message 
topq prioritize print 
memory id rernove a message 


a command immune to hangups and 
test your knowledge 


simple random-number generator 
random number generator 

simple 

rational Fortran dialect 

split 77, 


entry of a common object file 
header of a common object file 
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DEOTIC DOT onde: occcaeaneereannra i daenbeacre. profil(2) | 
profile Setting UP AN occ profile(5) Z 
profile within a function prof... prof(5) 

DROME SOUMING | 52, a rccem scala invented eu! profile(4) 

DONO E SACD: tik aie a csietaeds hentai tierents sadp(1m) 

ONGOING. tine acctrtssaanecern ease icon vanlaceataceictns profiler(1m) 
DIOGFAM ACO innit cxec cena iment abort(3F) 

program assertion assert ...........0.0 008, assert(3X) 
program beautifier CD 0... ees cb(1) 

DrOGram: CNECKEL HIN ccisscistemcmsssiesosmaosss lint(1) 

program cross-reference cxref ............... cxref(1) 

program debugger ctrace ........... ctrace(1) 

DROGTARI ON acs canosneseceletutieaumedlt ins end(3C) 

program name and get arguments ........ getargv(2s) 

DFOGT SAIN: SOIT cx.ouss crmmnaiet on uasmaadtinuantedars sdiff(1) 

DFOG ANY LIES sie dascsteieted Gaveb iu deeanar stan units(1) 
programming language sh shell, ........... sh(1) 

programs bs compiler/interpreter ........... bs(1) 

programs for simple lexical tasks ........... lex(1) 

programs make maintain, ....0. make(1) 

provide drill in number factS ............06. anthmetic(6) 
provide truth values tru@ ou... ee true(1) 

OF SS scrapie eecatncen naa potaaeamindcitnaasa es otanes prs(1) 

DS ceil eaten mi nnigennimepntanuge ps(1) 
pseudo-random numbers drand48 ........ drand48(3C) 

pt IMSP poteege controller 0... pt(7) = 
2) eg 01 - en eee ee ee eae ees ptrace(2) 
DIG sol scnsidinoe cance sy keene nila cam naeintecenes ekaeaies ptx(1) ae 
public UNIX-to-UNIX system file ............. Uuuto(1) 

push character back into input .......00..... ungetc(3S) 

put a string on a stream puts ow. puts(3S) 

put character or word On @ ....... putc(3S) 

OUTCRY: CHAN GOs ccciererinactnliceeseuagnecered putenv(3C) 

DI PWOEAE cs:ccpincearianstceaenstowntiulver euanueeie putpwent(3C) 

DUIS st cnartan wpa re eee puts(3S) 

DWC 3 doi ercchrstecereiotbniecdhndiaade duagilanids pwcek(1m) 

WIGS scat se 0i te rcs an tote eae ema omleetzeie pwd(1) 

OSOM serine ea tibetan, qsort(3C) 

query terminfo database tput ..........0...... tput(1) 

QUEUE MSGGET ....... eee eee eeteeeeereeeeeeees msqgget(2) 

QUCUC tcc. hen ticiaeaalanwemr nnd topq(1m) 

queue, semaphore set or shared .......... iperm(1) 

quicker Sort GSOMM oo... eeeeerees qsort(3C) 

QUITS NORUS TUG nat ayen nies, nohup(1) 

CUS oi costasicessiietpitinceg deciuicaeniae, Gacociaalal Gaseiaen quiz(6) 

ramdisk memory aS disk ou... ramdisk(1m) 

PANG tress ton spices natas hase sase tapout oraieant phasis rand(3C) 

FANG: farce in lodsete tag ateanateatnren rand(3F) 
random-number generator rand ............. rand(3C) 

AUG, sess Secndiink se wesneentae ceaneesaraenG salaseni ratfor(1) 

ratfor, or efl files fsplit 0.000 ee, fsplit(1) 7 
rational Fortran dialect ratfor 0.0.00... ratfor(1) 
read a password getpasS oe getpass(3C ho J 
read an indexed symbol table ................ \dtbread(3X) 

read an indexed/named section ............ ldshread(3X) 
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send mail to users or 


member of an archive file 
object file Idfnread 

read from file 

move 

lseek move 

open a common object file for 
open for 

open open for 

get real and effective user, and 
get real and effective user, 
get real and errective user, 
real effective group get 
specify what to do upon 
specify Fortran action on 
from per-process accounting 
extract error 

tape frec 

regular expression compile 
and execute regular expression 
make maintain, update, and 
compile and match routines 
match routines regexp 


regcomp 
compile and execute 

files comm select or 

lorder find ordering 

join 

for a common object file 

of a common object seek to 
common object file reloc 


_functions floor, ceiling, 


mod Fortran 


uuxqt execute 

L.cmds 

Spawn getty to a 

file rmdel 

semaphore set or shared memory 


constructs deroff 

consistency check and interactive 
consistency check and interactive 
report 


communication facilities 


=. blocks df 


process a 
system activity 
activity timex time a command; 
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read from file read ................ccccceeceeees read(2) 
(Ea TOM SG ses Gane dediereieaschiiaiets read(2s) 
read mail Mail oo... tee ee eeeceee mail(1) 
read one line lin€ o......e line(1) 
read the archive header ofa ue, Idahread(3X) 
read the file header of a common ......... Idfhread(3X) 
FOO) cates, fo nace Za tad Gaara ete: read(2) 
read/write file pointer Iseek ..............00.... lseek(2) 
read/write file pointer oo... lseek(2s) 
rEAGING IDOPEN oo... cece helene, Idopen(3X) 
reading or writing Open ee open(2) 
reading Of WIitiNg ....... ee ee open(2s) 
real and effective group ID oo... getuid(2s) 
real and effective group IDs .................. getuid(2) 
real and effective group, ............00c getuid(2) 
real and effective user, «0.0... getuid(2) 
receipt of a signal 0. ee signal(2) 
receipt of a system signal ..........000.000. signal(3F) 
records acctcms command summary ... acctcms(1m) 
records from dump errdeéad ................00. errdead(1m) 
recover files from a backup ..........00.. frec(1m) 
FO GCI DY its cation Setencaciat areal daneeaua dan regcmp(1) 
FEGCIND COM DNC -ncisciniareddahateatedecndersiaves regcmp(3X) 
regenerate groups of programs. ............. make(1) 
regexp regular expression ...........00..00. regexp(5) 
regular expression compile and ............. regexp(5) 
regular expression compile regcmp ....... regcmp(1) 
regular expression compile .............. cakehe regcmp(1) 
regular expression regemp ................6.. regcmp(3X) 
reject lines common to two sorted ......... comm(1) 
relation for an object library oe. lorder(1) 
relational database operator .................. join(1) 
reloc relocation information ................0. reloc(4) 
relocation entries of a section ................ Idrseek(3X) 
relocation information for a .........0.....08 reloc(4) 
remainder, absolute value .................... floor(3M) 
remaindering intrinsic functions .............. mod(3F) 
reminder service calendar ..................... calendar(1) 
remote command requests ................... uuxqt(1m) 
remote execution commands ................. L.cmds(4) 
remote terminal Ct... eeceeeee ct(1) 
remove a delta from an SCCS ............... rmdel(1) 
remove a message queue, .................5. ipcrm(1) 
remove directory entry unlink .......00...00.. unlink(2) 
remove files or directories rm 0... rm(1) 
remove nroff/troff. tol, and eqn ............... deroff(1) 
repair fsck file systeM 0... ee fsck(1m) 
repair fsck file system ...........0 ee, fsck(8) 
repeated lines in a file uniq .......0....0. uniq(1) 
report CPU time used clock ................... clock(3C) 
report inter-proceSS oo... ipcs(1) 
report number of free disk 0.0.0... df(im) 
report of logged errors errpt ....... errpt(im) 
report package Saf... eee sar(1m) 
report process data and system ............ timex(1) 
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uniq 

system activity 

stream fseek 

requests start/stop the LP 
send/cancel 

uuxqt execute remote command 
restore 

incremental file system 

iphold postpone printing, 
object file symbol table entry 
argument getarc 

variable getenv 

mclock 

abs 

len 

substring index 

logname 

name getenv 

data 

filter 

create a new file or 

drive 

remove files or directories 
remove a delta from an SCCS file 
change 

chroot change 

logarithm, power, square 
Fortran square 

Fortran nearest integer functions 
graphical device 

common object file access 
expression compile and match 
graphical table of contents 
float and double 

as a disk 

nice 

and quits nohup 

run daily accounting 

SCCS file editing activity 

disk access profiler 

system activity graph 

system activity report 

system activity report package 
convert formatted input 

big file 

awk pattern 

programs 

two versions of an SCCS file 
format of SCCS file 

start/stop the LP request 
header for a common object file 
package curses CRT 

editor based on ex vi 

inittab 
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report process statuS PS oo... ps(1) ‘ 
report repeated lines in a file 0... uniq(1) 7 
FEDOM Sal igesawulsititensvncnem iranian sail(1) 

reposition a file pointer ina... fseek(3S) 

request scheduler and move ................. lpsched(1m) 
requests to an LP line printer Ip -....0....... Ip(1) 

FOQUGSIS a eacicctcisitisounosincne siecle aan uuxqt(im) 

restor incremental file system ................ restor(8) 

FOSIOlE so recesindtcroutioneanerana restor(1m) 

FOSUME PANING cect a wee: iphoid(1) 

retrieve symbol name for common ........ Idgetname(3X) 
return Fortran command-line .................. getarc(3F) 

return Fortran environment ......0..... getenv(3F) 

return Fortran time accounting .........00... mclock(3F) 

return integer absolute value ................. abs(3C) 

return length of Fortran string ................ len(3F) 

return location of Fortran .........0..0...06.0. index(3F) 

return login name of user ow. logname(3X) 
return value for environment ...........0...... getenv(3C) 
returned by stat system call stat ............ stat(5) 

reverse line-feedS COl ou... eee col(1) 

rewrite an existing one creat ow... creat(2) 

rm Cipher Microstreamer tape ................ rm(7) 

Ee, Sua gaste Roden rane leneetads en ene: rm(1) 

WITICON (hei ig sn naet Seon ac ca ate eg anor ematmed acters rmdel(1) 

root directory Chroot ....... eee chroot(2) . ~ 
root directory for a command ..............0. chroot(1m) ‘\ 
root function exp exponential, ............. exp(3M) pee 
root intrinsic function sqrt... sqrt(3F) 

COUAG) crccatases diay castnnectectatae cates round(3F) 

routines and filters qdev ow... gdev(1) 

POUTINGS IGICN cnt hit itinerice es idfcn(4) 

routines regexp regular o.oo... regexp(5) 

FOUDNECS TOG since Suivctaditasesidvinenes okiptenetinke toc(1) 

FOUUNES uc tivilnttelsccieaet endeadntineencdenends float(2s) 

rram allows memory to be used ............ rram(7) 

run a command at low priority 0.0... nice(1) 

run comm immune to hngup .................. nohup(1) 

PURACE! ie ingnteamteninaiasuatnnearaietemaat runacct(im) 

Sact PriNt CUITENT 0. eeeeeees sact(1) 

Sad0: cviuestus accel tape tenenpicunens sadp(1m) 

SAG icteanieo ati nere eee ee $ag(1) 

= | | eo EE Ree RCO ear Re Oe te ee sail(1) 

SAPs eionlincute steele table sree enn tel atedtiinedeaien sar(im) 

SCAN enec stinkin Na caraasiare tanned scanf(3S) 

SCANMNMEM DIS: 6 sca iac kas iin eecnieiess ede asareess bfs(1) 

scanning and processing language ....... awk(1) 

scc C compiler for stand-alone .............. scc(1) 

sccsdiff compare .......... ee sccsdiff(1) 

SCCSING = wc siatiianvanases as inaeek cape ccuateentanncae sccsfile(4) 
scheduler and move requests ............... Ipsched(1m) 
SCHNG! SCCON. a sthincs acsnuimianicnions senhdr(4) 
screen handling and optimization .......... curses(3X) | | 
screen-oriented (visual) display ............. vi(1) See 
script for the init process ......... inittab(4) 


‘slits 
: 
a ee 


b system initialization shell 
side-by-side difference program 


grep 
binary 


accounting file(s) acctcom 


linear 
manage hash 
manage binary 


object file scnhdr 

file read an indexed/named 
seek to line number entries of a 
seek to relocation entries of a 
seek to an indexed/named 


files size print 
stream editor 


section of a common object 
section of a common object file 
of a common object file 
common object file idtbseek 
get shared memory 


change data 
brk change data 


to two sorted files comm 


( 


file cut cut out 
dump dump 
semctl 


ipcrm remove a message queue, 


get set of 


semaphore control operations 
get set of semaphores 
semaphore operations 


group 
a group 


map of 


of processes kill 
of processes kill 
mail 

line printer Ip 
reminder 


umask 

umask 

ASCII character 
execution env 


modification times utime 


umask 
get 


remove a message queue, semaphore 
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SCUIPIS OFC itancs cate eur tunienaa bre(1m) 
SOUT tas dooteatansnteieiea tag itsealianytarn tae ie sdiff(1) 
search a file fora pattern oo. grep(1) 
search a sorted table bsearch ............... bsearch(3C) 
search and print process ....0.. i e. acctcom(1) 
search and update Isearch ........0 lsearch(3C) 
search tables hsearch |... hsearch(3C) 
search trees tS@arch 0... eeees tsearch(3C) 
section header for a common ................. scnhdr(4) 
section header of a common object ...... Idshread(3X) 
section of a common object file ............. Idlseek(3X) 
section of a common object file ............. ldrseek(3X) 
section of a common object file ............. Idsseek(3X) 
section sizes of common object ............ size(1) 
SEO) Sauer daa oe ae sed(1) 
seek to line number entries of a ............ Idiseek(3X) 
seek to relocation entries of a ................ ldrseek(3X) 
seek to the optional file header .............. idohseek(3X) 
seek to the symbol table of a... ldtbseek(3X) 
segment SAMGet uo... ccecesceceseseeeeees shmaget(2) 
segment space allocation brk ou... brk(2) 
segment space allocation oo... ork(2s) 
select or reject lines common ............... comm(1) 
select terminal filter greek oo... greek(1) 
selected fields of each line of a ow... cut(1) 
selected parts of an object file 00.00.00... dump(1) 
semaphore control operations ................ semctl(2) 
semaphore operations semoop ................ semop(2) 
semaphore set or shared memory id .... iperm(1) 
semaphores Semaet .............cceteeees semget(2) 
SOMCU i icacicsicusewngiasmesmatareonsaest semctl(2) 
SOMOCl ssn cit trate mies eer eae eealsiss semget(2) 
SOMON -dixesicsaecmeenespdamoesntieatn semop(2) 
send a signal to a process or a ............. kill{2) 
send a signal to a process or .............. kill(2s) 
send mail to users or read mail ............. mail(1) 
send/cancel requests to an LP 0... lp(1) 
SEriCe CAlENdal «0.0... cece ccc eeeseeees calendar(1) 
set a process alarm clock alarm ............ alarm(2) 
set and get file creation mask ............... umask(2) 
set and get file creation mask 0.0.0.0... umask(2s) 
SOt GSClls aics nine cactus eetn ascii(5) 
set environment for commana ............... env(1) 
set file ACCESS ANd... etre renee utime(2) 
set file-creation mode mask .............00... umask(1) 
set of semaphores semget ...............008 semget(2) 
set or shared memory id iperm .............. ipcrm(1) 
set process group ID setpgpp ................. setpgrp(2) 
set tabs on a terminal tabs ......0.00000. tabs(1) 
set terminal characteristics .........0...004. stty(2s) 
set the date date 0.0.0... cece ceeeceees date(1) 
set the options for a terminal ..........0.0.... stty(1) 
Set tiME STIME oo. ccc tt eteees stime(2) 
SEt TMG sohbet caine eae stime(2s) 
set user and group IDs setuid ................ setuid(2) 
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get and 

assign buffering to a stream 
establish mount table 

set process group ID 

login time profile 

login time profile 

speed and terminal 

set user and group IDs 

of one merge same lines of 
command programming lanquage 
shmctl 

a message queue, semaphore set or 


get 

issue a 

issue a 

system initialization 

command programming language sh 
shared memory control operations 
get shared memory seqment 

shared memory operations 
terminate all processing 

sdiff 


intrinsic function 

suspend process until 
processes kill send a 
processes kill send a 

on receipt of a system signal 
to do upon receipt of a signal 
software 

generate programs for 

troff preprocessor for drawing 
rand 

Fortran 

Fortran hyperbolic 

hyperbolic functions 

sine intrinsic function 

print section 

interval 

suspend execution for an interval 
suspend execution for interval 
for typesetting viewgraphs and 
documents, viewgraphs, and 
current user ttyslot find the 
interpolate 

SNOBOL interpreter 

file perusal filter for 


quicker 

topological 

or reject lines common to two 
binary search a 

change data segment 
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set user limits UliMit 0... cece ulimit(2) 
SCIOUE carci a raiclanet Fauve: setbuf(3S) 
SEUNG 65s isco ya ovser enc atinuensauctate test aise rice setmnt(1m) 
SOIDGID: biciah eels Moat eanaenaeceea le setpgrp(2) 
setting up an environment at ............0.. profile(4) 
setting up an environment at ...........008. profile(5) 
settings used by getty gettydefs ............ gettydefs(4) 
SOWA: a vstirincipdrssetorierutameratucmantanatead setuid(2) 
several files or subsequent lines ........... paste(1) 

sh the standard/restricted 0... sh(1) 
shared memory control operations ........ shmctl(2) 
shared memory id ipcrm remove ........... iperm(1) 
shared memory operations shmop ........ shmop(2) 
shared memory segment shmeet .......... shmget(2) 
shell command from Fortran sys ........... system(3F) 
shell command system ........... ee system(3S) 
Shell Scripts OFC oo. eens ereeee brc(1m) 
shell, the standard/restricted .........0...0.... sh(1) 
SIC ie tntedeatiaetechen earstaete Mam atastay, shmctl(2) 
SMG certacen nerve tairigicensaccnasarsyuatlestee suerte shmaget(2) 
SIMO es eoncreaneesnaraecatnemeeceusaanteatomss shmop(2) 
SMUTIOWN aa ce cessasactaaremrascoamescaveenccurs shutdown(1m) 
side-by-side difference program ............. Sdiff(1) 
SIGH ON OGIN 5s cersaadereviases cehsusdeeedseeraragece: login(1) 
sign Fortran transfer-of-sign oo... sign(3F) 
SIGM Al CAUSE c25h io iccaerhntsemomesis hain pause(2) 
signal to a process or a group of ........... kill(2) 
signal to a process or a group Of ........... kill(2s) 
signal specify Fortran action .......0.0.000.. signal(3F) 
signal specify what oo... ee signal(2) 
Signals SSIQNAl 0... ccecteeeterreeeees ssignal(3C) 
simple lexical tasks lex oe lex(1) 
SIMPIE PICTUFES PIC eee pic(1) 


simple random-number generator .......... rand(3C) 


sine intrinsic function SIN... sin(3F) 
sine intrinsic function sinh 0.0... sinh(3F) 
SIMA sicecdcc cont ve ster eievcceumcsus una vea eoiiavcantaeiee sinh(3M) 
sinh Fortran hyperbolic ..............e. sinh(3F) 
sizes of common object files size ........... size(1) 
sleep suspend execution for ...........0008. sleep(2s) 
SICSD > de ararsctaterprcnnun eared vo esomae sleep(1) 
BICC Diaper a attarcnliarincrrmnctaemnneies sleep(3C) 
slides a troff macro package ................ mv(5) 
slides mmt typeset .......... cece mmt(1) 
slot in the utmp file of the ow, ttyslot(3C) 
smooth curve spline oo. eee spline(1) 
GMO: Ati Gace iierseclitainees ot anatots sarees sno(1) 
soft-copy terminals pg... ee pq(1) 
software signals ssignal ...............0.005 ssignal(3C) | 
sort and/or merge files sort 0.0.0... sort(1) 
SOM GSM ecsaitstcnddut wanranaacenguatsraeae qsort(3C) 
SOM ISO es wishin emmmmaiiarmenntoints tsort(1) 
sorted files comm select ........0.... comm(1) 
sorted table bsearch ou... eeeeee bsearch(3C) ~~ 
space allocation Drk oo... ee brk(2) 
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brk change data segment 
terminal ct 

for eqn and neqn eqnchar 
build 

create a new 

mknod make a 

300s terminals 300 handle 
2621-series terminals handle 
terminal 450 handle 

make a directory ora 
format 

isatty returns a 1 if 

of a system signal signal 
of a signal signal 

by getty gettydefs 

find 

interpolate smooth curve 


context 

fsplit 

uucp 

configure the LP 

in a machine-independent fashion. 
square root intrinsic function 
exponential, logarithm, power, 
sqrt Fortran 

file number on a tape 


compatibility checker mmiint 
software signals 

scc C compiler for 

package stdio 

communication package stdipc 
programming shell, the 
scheduler and move requests 


data returned by 

get file status 

data returned by stat system call 
useful with graphical commands 
graphical commands stat 

list file names and 

get file system 

ustat get file system 

print LP 

stream 

uustat uuCcp 

communication facilities 

System control and 

report process 

get file 

stat get file 

buffered input/output package 
communication package 
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Space allOCAation oo... cece cerentees ork(2s) 
spawn getty to a remote ....... ct(1) 
special character definitions ..000.0.0.... eqnchar(5) 
special file MKNOd .0.... i eee mknod(1m) 
SPCC! al TUG cassie sectntacntu aerate Aveedsearieutent Sone creat(2s) 
SPCCial TNS sacicdccvsciceeeresaneianccesevieeasaiene tele mknod(2s) 
special functions of DASI 300 and ......... 300(1) 
special functions of HP 2640 anc .......... hp(1) 
special functions of the DASI 450 ......... 450(1) 
special or ordinary file mknod ................ mknod(2) 
specification in text files fspec 0.0.0.0... fspec(4) 
specified file descriptor isa on... isatty(2s) 
specify Fortran action on receipt ............ signal(3F) 
specify what to do upon receipt ............. signal(2) 
speed and terminal settings used .......... gettydefs(4) 
spelling errors spell ........... cence spell(1) 
SDUNG suraridon i emrevetraserenoutnideddnntanerenntaeiied spline(1) 
split a file into pieces split 00, split(1) 
SDI CSOU i csnastedscnsestas tase caasuiacparentns Ceiuson csplit(1) 
split f77, ratfor, or efi files oc . fsplit(1) 
spool directory clean-up uuclean ........... uuclean(1m) 
spooling system Ipadmin ...... lpadmin(im) 
sputl access long integer data ............... sputl(3X) 
SGM ROAM 4. cicct Monnaie Notsts ane: sqrt(3F) 
square root function Exp ........ ee exp(3M) 
square root intrinsic function .........00.... sqrt(3F) 
srcheof position to a specific ............00... srcheof(2s) 
Sroff format text oo... ceccccceeeerereeeeees sroff(1) 
sroff,MM nroffiMM document .......0.0.000. mmilint(1) 
SSIGU Al canecn tunity ataretee ecu ssignal(3C) 
Stand-alone programs ou... ees scc(1) 
standard buffered input/output ............... stdio(3S) 
Standard interprocess o..... eee stdipc(3C) 
standard/restricted command ................ sh(1) 
start/stop the LP request .........0.. ee. lpsched(1m) 
Stat get file statUS 0.00... eects stat(2s) 
Stat system call Stat oo... ee stat(5) 
Slabs site el sa tadtnse west ngnPueanee cua ons stat(2) 
Slat wikis mn oe ostieeehateean es stat(5) 
Stat Statistical network 0.000. stat(1) 
Statistical network useful with .....0.0... stat(1) 
statistics for a file system ff oo... ff(1m) 
Statistics UStat 0... eeeaants ustat(2) 
SLATS CS sat Sea aera var on evra any eenuenaee aca ustat(2s) 
Status information Ipstat ......00.00 ae. Ipstat(1) 
Status inquiries ferror 0.0.0... eee ferror(3S) 
status inquiry and job control ............... uustat(1) 
Status ipcs report inter-process .............. ipcs(1) 
STATUS PlOGla) vovassueriaradccthineatilerieerdes sys(1m) 
StAtUS DS i sinciovectteitsietternamene tanto ee ps(1) 
StaluS Slat. sanatiwintien stereos eae stat(2) 
SlAtUS snl acendarwngs tain dinette stat(2s) 
StIdiO: SlANG Ald) cin ccvewtiuesintteceuta ices stdio(3S) 
stdipe standard interprocess .................. stdipc(3C) 
StIME: SENTING cc. ccclinarcanetelecuaaee stime(2s) 
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set time 
wait for child process to 
comparision intrinsic functions 


close or flush a 

open a 

reposition a file pointer in a 
get character or word from a 
get a string from a 

put character or word on a 
put a string ona 

assign buffering to a 


push character back into input 
ft IMSP 

long integer and base-64 ASCI 
functions strcmp 

convert date and time to 
convert floating-point number to 
get a 

return length of Fortran 

put a 


strtod convert 

convert 

string operations 

gps graphical primitive 
information from a common 

from a common object file 

string to double-precision number 
convert string to integer 
processes using a file or file 
characteristics 

set the options for a terminal 
become super-user or another user 
graphics interface 

same lines of several files or 
return location of Fortran 

and block count of a file 


du 

accounting records command 
update the 

update 

become 

document analyze 

interval sleep 

sleep 

sleep 

pause 

swap bytes 

information from a strip 

file symbol table retrieve 
name for common object file 
object compute the index of a 
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stop or terminate wait 
strcmp string 
stream editor sed 
stream fclose 
stream fopen 
stream fseek 
stream getc 
stream gets 
stream putc 
stream puts 
stream setbuf 
stream status inquiries ferror 
stream ungetc 
streaming cartridge controller 
string a64l convert between 

string comparision intrinsic 
string ctime 
string ecvt 

string from a stream gets 
string len 
string on a stream puts 
string operations string 
string to double-precision number 
string to integer strtol 
string 
string, format of graphical files 
strip symbol and line number 

strip line number information 

-Striod convert 
strtol 
structure fuser identify 


stty 
stly 
SU 


subroutines plot 
subsequent lines of one file 
substring index 
sum print checksum 
summarize disk usage du 
summarize disk usage 
summary from per-process 
super block sync 
super-block sync 
super-user or another user su 
surface characteristics of a 
suspend execution for an 
suspend execution for interval 
suspend execution for interval 
suspend process until signal 
swab 
symbol and line number 
symbol name for common abject 
symbol table entry idgetname 
symbol table entry of a common 


ewe ae ee eee ene ete emeaeeeeease teres eseeeestoetrrpeetrees  eeeseeese 
Bethe fe ieh gic ant Rae Neat 8 
sleet edie decal rceclesdantasouaainea sche teeeeoas 
site castes desert tame taie aus iat 
ie bat Pia an Ne gerd et nee hae 
Ce ET Te FETE TORT 
FRE oR eae eT Sm ee ree tt 
sabia noun sock eon eine esied ate baat 
ORT TR PRET ee NER Ie RETRO eT Ne 
Recaps be ceathscrs tang Meenas Sty ee aaa Ne 
Pe Rane eh aa fat i acd ak Ra ae 
Ae teed roe eatea hada eC eas anes 
bec ehdcnen satiate 
Shes isaac Suse ascaetsa ae eens 
sheseiderparsomce 
elder aneatece ss 
taeda 

seater heal ena tice eengtvcidaemntten 
il haat eee haccise don Gesecm te tee tees ea cleae 
ppt Matte 
Nick its ica a su deol Meee Eu Oe Es teas 
it gee canecneescoae babes 
ahi ate da eee dma 
Biheauie, 
Lancs weimeaisdestettaans 
ciate tie acteclis Sepsn Sects oa es dened te tania es 

pak neraeayd 
sacs pasiaedan 
Seeetcnatcnad eee 
idee acectatie ie ae Buena asratiaate Muy asrstted 
BOs caret basin te Nan Ate incite et Ae toast iS 
Sele Oa tea ead setae 
set terminal ...............c.ccccccccececceceaeeees 
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stime(2) 
wait(2) 
stromp(3F) 
sed(1) 
fclose(3S) 
fopen(3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
putc(3S) 
puts(3S) 
setbuf(3S) 
ferror(3S) 
ungetc(3S) 
ft(7) 
a64\(3C) 
stromp(3F) 
ctime(3C) 
ecvt(3C) 
gets(3S) 
len(3F) 
puts(3S) 
string(3C) 
strtod(3C) 
strtol(3C) 
string(3C) Pan 
gps(4) | 
strip(1) — 
strip(1) 
strtod(3C) 
strtol(3C) 
fuser(1m) 
stty(2s) 


plot(3X) 
paste(1) 
index(3F) 


sync(1) 


sleep(1) 
sleep(2s) 
sleep(3C) 
pause(2) 
swab(3C) 
strip(1) F 
Idgetname(3. 
Idgetname(3X)—~ 
Idtbindex(3X) 
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object file read an indexed 
common object file 

file Idtbseek seek to the 
object file symbol table format 
update the super block 
update super-biock 


C 


sar 


command; report process data and 
daily/weekly UNIX system file 
data returned by stat 
exercise link and unlink 
checkall faster file 
UNIX-to-UNIX 

interactive repair fsck file 
interactive repair fsck file 

file ioctl.syscon 

UNIX system to UNIX 

what to do when the 

call another UNIX 

primitive 

file 

fsdb file 


names and statistics for a file 
public UNIX-to-UNIX 

filesave daily/weekly UNIX 
examine 

scripts orc 

configure the LP spooling 
interactive message processing 
| construct a file 
mount and dismount file 

- mount a file 

operating 

incremental file 

Fortran action on receipt of a 
get file 

ustat get file 

mounted file 

UNIX 

unmount a file 

print name of current UNIX 
get name of current UNIX 
format of 

who is on the 

mount a file 

issue a shell command 

a sheil command from Fortran 
dcopy copy file 

checklist list of file 

volcopy copy file 

binary search a sorted 

for common object file symbol 


ia a oy 
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symbol table entry of a common ........... Idtbread(3X) 
symbol table format syMS oo... syms(4) 
symbol table of a common object .......... Idtbseek(3X) 
SVMS (COMIMON: - cr .cideisescantaainndvovrvedane syms(4) 
SVG 25s voidiont ea ecewnaneeeteetmaakeesaee aes sync(1) 
SVG tire ca en ainda aerdunimatieantias sync(2) 
system activity grapn sag ....... ee. sag(1) 
system activity report package ............... sar(1m) 
system activity report Sail sail(1) 
system activity timex time a ......... ore timex(1) 
system backup filesave 0... filesave(1m) 


system Call Stat 0.0.00... ee cceeee ees stat(5) 


system CallS lINK oo... cece eee seeees link(1m) 
system checking procedure ................. checkall(1m) 
system command execution uux ........... uux(1) 
system consistency check and .............. fsck(im) 
system consistency check and .............. fsck(8) 
system console configuration ................. ioctl syscon(4) 
SYStEM COPY UUCP oo... eee uucp(1) 
system crashes Crash oo... eens crash(8) 
SYSIGMICU) cua racuceerucman maw oaneeeuna ees cu(1) 
system data types types ...... i e types(5) 
system debugger fsdb ou... ee fsdb(1m) 
SYSTEM GEDUGGES 00... ce ceeee tees fsdb(8) 
system error messages perror ............... perror(3C) 
system ff list fl€ ooo ecceeceteetees ff(1m) 
system file Copy UUtO oe uuto(1) 
system file system backup ...........0000. filesave(1m) 
system images crash ......... ees crash(1m) 
system initialization shell 0... brc(1m) 
SYSTEM ![PAMIMIN o.oo... eee ececeeseeenenetereeeees lpadmin(1m) 
SYSIGM MANIK: Aawisia tases iemesiecnnieraalenies mailx(1) 
SYSIEM MHKIS: <0 dancomiauieaead mkfs(1m) 
SVSIOMAINOQUING nia desoeteiecatecete me ciiceuayavetes mount(1m) 
SYSTEM MOUNE oo... cece scceetesttteceeeeeeeeeeeees mount(2) 
system profiler profiler... ee profiler(1m) 
SYSTEM FESTOLE 00... ceesseecccsttectrertteeseees restor(im) 
system signal signal specify ...........00.... signal(3F) 


system statistics ustat ...0... ee ustat(2) 


system statiSticS eee UStat(2S) 
system table mnttab ......... eee mnttab(4) 
system to UNIX system copy uucp ........ uucp(1) 
system umount 0.0... Peres cate umount(2) 
SYSTEM UNAME ooo. cece tere rates uname(1) 
SYSTEM UNAME oon... ect teeters uname(2) 
system volume fs .......... isabel ental fs(4) 
SVSIOIN WO) bsccacstesiansntecvirastectranoamieraetys who(1) 
SYSTEM 00... Pisa Seite isiben et dusty beeaes mount(2s) 
SVS OI ecrrtasinsd eee iedneiadites system(3S) 
SYSTEM ISSUE occ cetteeeeertee neers system (3F) 
systems for optimal access time ............ dcopy(1m) 
systems processed by fsck 0... checklist(4)° 
systems with label checking .........000.00. volcopy(1m) 
table DSEAICN oo. ce eee Pe kenarie. bsearch(3C) 
table entry Idgetname name 


seialesbaecacvae Idgetname(3x) 
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compute the index of a symbol 
file read an indexed symbol 
common object file symbol 
mounted file system 
Idtbseek seek to the symbol 
graphical 

establish mount 

tb! format 

manage hash search 

set tabs on a terminal 
deliver the last part of a file 
Fortran 

tangent intrinsic function 
foackup make a fast 
foackup make a fast 

rm Cipher Microstreamer 


dump incremental dump 
recover files from a backup 
tape file archiver 

programs for simple lexical 
troff 

deroff remove nroff/troff, 


of a file pointer 

create a 

create a name for a 

format of compiled term file. 
conventional names for terminals 
data base 

paginator for the TEKTRONIX 4014 
special functions of the DASI 450 
EOT on the other 

termcap 

terminfo 

gtty get 

stty set 

spawn getty to a remote 
generate file name for 

select 

routines termlib 

controlling 

tty general 

establish an out-going 

gettydefs speed and 

set the options for a 

set tabs on a 

get the name of the 

find name of a 

ttytype data base of 

functions of DASI 300 and 300s 
of HP 2640 and 2621-series 

file perusal filter for soft-copy 
conventional names for 
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table entry of a common object ............. idtbindex(3X 
table entry of a common object ............. ldtbread(3X) 
table format SYMS 0.0... eects syms(4) 
TaDIO MNMAD -secinteistisheies ict vietiecers mnttab(4) 
table of a common object file ................. idtbseek(3X) 
table of contents routines toc ................. toc(1) 

TADIO SUMING cccteuszssrcstssreanciantan icon aivavedene setmnt(1m) 
tables for nroff or troff oo... eee tbi(1) 

tables NS€AIrCH ooo... cece cece tee ete ees hsearch(3C) 
TAOS. wera nataeciaistntieedecaner sheen neat: tabs(1) 

Cell setsadhaatstacatoctevaletenaievareoteusnd oc evasoreetoanas tail(1) 
tangent intrinsic function tan oo... tan(3F) 

tanh Fortran hyperbolic oo... tanh(3F) 
tape backup of a file system .........0.00.. fbackup(1m) 
tape backup of a file system 0.00... foackup(8) 
TADO! CVO  saitetielconceatiieacacinermnads rm(7) 

tape file archiver tar oo... eee tar(1) 

TADS TOF AL ware Gerclaraievorteia tenilade exits dump(4) 
TADS IOC wrscecercerajantrusaseenecicevetmee. frec(1m) 

LAU tis cecxe pie ronasnernns ant aauh eames nmanees tar(1) 

tasks lex Generate ........ cere lex(1) 

tb! format tables for nroff or 0.0.0.0... tol(1) 

tol, and eqn constructS ......... cen deroff(1) 


tc troff output interpreter oe tc(1) 


tell report the current value... tell(2s) 
temporary file tmpfile oo... es tmpfile(3S) 
temporary file tMpnamM ............. eee tmpnam(3S) 
TOIT “rcdiseteice Cts Gestion clacesnincaee hed aeheaaes term(4) : 
TOE: Sah tate iritaanmurier aaateoeoanens term(5) 
termcap terminal capability 0.0... termcap(4) 
terminal 4014 oo cece tteeereeeees 4014(1) 
terminal 450 handle woes 450(1) 
terminal and exitS. write 0... write(1) 
terminal capability data base .......0.0....... termcap(4) 
terminal capability data base .......0....0.... terminfo(4) 
terminal characterisitcs .........0.ee. gtty(2s) 
terminal Characteristics 00.00... ee stty(2s) 
TEPMIN AMC ctinc<cierneatany an ah enone: ct(1) 

terminal ctermid ........cc cesses ceeseees ctermid(3S) 
terminal filter greek 0.0... dap eelacuatte ite greek(1) 
terminal independent operation .............. termlib(3c) 


terminal interface tty ............ cece tty(7) 


terminal interface ............. ee eee tty(7) 
terminal line connection dial ...........00... diai(3C) 
terminal settings used by getty .............. gettydefs(4) 
terminal Stty oo... cccecssseteeneeeeeeees stty(1) 
lerminal tabs sada ees wenn tabs(1) 
TOC IY. ess ite eter vasctsaicte ran aeaeeounm eee eiadas tty(1) 
terminal ttyname oo... eens ttyname(3C) 
terminal types by port... ttytype(5) 
terminals 300 handle special ................ 300(1) 
terminals hp special functions ................ hp(7) 
TOPIVIM AS 00-2 ercercrcxotecgacetacconsananennecteteny: pgq(1) 
terminalS term oo... ccceccceecceteseceeereees term (5) 
terminate Fortran program abort ............ abort(3F) 
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shutdown 


exit 
daemon errstop 
_ wait for child process to stop or 


query 

terminal capability data base 
operation routines 

command 


condition evaluation command 


Casual users edit 

change the format of a 
format specification in 

eqn format mathematical 
ocw prepare constant-width 
troff 

nroff format or typeset 

sroff format 

lock process, 


wump 
terminfo compiler 


data and system activity timex 
update access and modification 
set file access and modification 
get process and child process 
process data and system activity 
create a temporary file 

a name for a temporary file 
initiate pipe 

table of contents routines 


merge or add 

and modification times of a file 
graphics filters 

query terminfo database 
translate characters 

process 

function sign Fortran 


system uucico file 
walk a file 


OS 
\ 
, 
J 1 
i a 


manage binary search — 
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terminate a process kill ..............00c ee kill(1) 
terminate all proceSSing |... ee shutdown(1m) 
terminate process eXit 0... ee exit(2) 
terminate ProceSs 00.0... ee exit(2s) 
terminate the error-logging ...............08 errstop(1m) 
terminate Walt... cece eeeeeees wait(2) 
terminfo Compiler tic 0... ees tic(1m) 
terminfo database tput 00.0. tput(1) 
TOPIC ota hcrchietvwineicndvacesien ceca daatiareaaaeoe terminfo(4) 
termlib terminal independent ........ ee termlib(3c) 
test condition evaluation... ee. test(1) 
test your knowledge quiZ ........... quiz(6) 
TEST: aaron rien ad ensues toca wnt een test(1) 
1OMl BONOl CO) sd sete ves ark mee quseettiniens ed(1) 
(=). 416] | (0) dal), Guan en ne nee ex(1) 
text editor variant of ex for oe edit(1) 
text file NEWfOrM oo... cece newtorm(1) 
text filES FSPOC oo. ccecestetecceeseeeenes fspec(4) 
text for nroff or troff oes eqn(1) 
TEXT TOF OUOT os. Soro oraremceaueantian hans ocw(1) 
text formatting and typesetting ............... troff(1) 
TONE: hale ntaeet ataloeiiaateueagat aun nroff(1) 
NOME cauiee neater fiaacetsaanddesncetveehabaatednaseas sroff(1) 
text, or data in memory plock ................. plock(2) 
the C language preprocessor cpp .......... cpp(1) 
the game of backgammon back ............ back(6) 
the game of black jack Dj oe bj(6) 
the game of craps craps ........ .. craps(6) 
the game of hunt-the-wumpus ............... wump(6) 
the null file null oo... cee ereeeeees null(7) 
VIC cs crasttcasebaaksgaci dunia daSaceaueshaa as hanauess tic(1m) 
time a command tiMe ...... eee time(1) 
time a command; report process ............ timex(1) 
times of a fil€ toUCH oe eeeeeees touch(1) 
TIMES UTIME ooo. ccceceecececceseeecsena seen utime(2) 
TIPO S ec ciitiesnossat Morttindwlavecawtiuasegsrenee times(2) 
timex time a command; report ............... timex(1) 
LLL? 11 |= nen ene ee ee tmpfile(3S) 
IMPNAM: ChOAlE= cn ssascteinnniacomgen tmpnam(3S) 
to/from a PproceSS POpen ........ ee popen(3S) 
TOC GraDiiICal a .csdivasac tise Acros ideaesetes toc(1) 
topological SOrt tSOrt ores tsort(1) 
topq prioritize print queue oe, topq(im) 
total accounting files acctmerg ............... acctmerg(1m) 
touch update aCceSS ......... eee touch(1) 
TM OU ieeeainitacen tlestnnvsactousaven dia stead tua ceegeaainaed tplot(1) 
TUL ste eotcseereret cect tia tan cea ca emericiclanaah cuando tput(1) 
UD A cicsa tiara agepaeneatntactadaaaaansatiautetormemeantiy tr(1) 
WACS BW ECE: clearer centeay eaee ptrace(2) 
transfer-of-sign intrinsic oo... ee sign(3F) 
translate characters CONV ................6 conv(3C) 
translate Characters tr o.....ccccceccceee tr(1) 
transport program for the uucp ............... uucico(1m) 
WOO IW oh ines cena ecuavioinin ase anioea oe: ftw(3C) 
TEES TSCA ooo. ccecteecceseeeereeeeeeees tsearch(3C) 
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trigonometric fUNCHONS: “WIG® aacitaiigeidstonaupiechcavetrn tet trig(3M) ( 
| language troff description of output oe. troff(5) 
9700 printer dx9700 prepare troff documents for the Xerox ......... dx9700(1) 
typesetting viewgraphs mv a_ troff macro package for... eee mv(5) 
tc troff output interpreter oo... eee te(1) 
simple pictures pic troff preprocessor for drawing ................ pic(1) 
typesetting troff text formatting and «0... troff(1) 
tb! format tables for nroff or troff oo ee ccsesserttreeeeeeeeeeesseeeeeees tbi(1) 
mathematical text for nroffor troff eqn format ........ cee eeeeeeees eqn(1) 
files for device-independent troff font description 0... ee font(5) 
provide truth VaINeS: “ITU sinters ewe aleoniion true(1) 
provide truth valu€s tru@ oo... teres true(1) 
manage Dinary search tre@S [SCPC occ ccetteteteeeeeeeeeceeeeeeaes tsearch(3C) 
TODOIOGICAl SOM ISOM c.suitehics cies cencostwlaliuielecmenains uatemions tsort(1) 
tty general terminal interface .................. tty(7) 
get the name of the terminal tty 20.0... eeeeeteeteetttttettas ene tty(1) 
controlling terminal interface tty ...........c cece eee ees ks tty(7) 
find name of a terminal tfYNAME ooo... cceccetcceetnteeeseeeeennas ttyname(3C) 
the utmp file of the current user ttyslot find the slotin 0.0.0... ttyslot(3C) 
types by port ttytype data base of terminal 0.00... ttytype(5) 
explicit Fortran type conversion ftype ...............cc cee ftype(3F) 
determine file type file oo. eceereeees ves file(1) 
primitive system data tyP@S tYP@S oo... eee rere eerie ties types(5) 
and slides mmt_ typeset documents, viewgraphs, ............ mmt(1) 
AFOT fOrMAat OF  TYPESEUTOXE ishsccuswasaecienionaraneas nroff(1) 
mv a troff macro package for typesetting viewgraphs and slides ......... mv(5) 
troff text formatting and typesetting occ ceerenereeeereees troff(1) 
get and set user limits UNIMIt oo cceececeeceeeeseneeeeas eee ereeed ulimit(2) 
creation mask umask set and getfile 00, umask(2s) 
set file-creation MOdE MASK UMASK ou... ccccccccccceeseeeeceeeesuseesesenss umask(1) 
umount unmount a file system ............... umount(2s) 
unmount a file system umount... Carat ipadieot einem umount(2) 
print name of current UNIX SySt@M UNAME oo ccceeeeeeeeeetnerteneaaaee uname(1) 
get name of current UNIX SystEM UNAME ou... eee eeeeteteeeteteeereeeees .. uname(2) 
file unget undo a previous get of an SCCS ........... unget(1) 
a previous get of an SCCS file unget UNdO ou... ccc ceceeeneseeeenees unget(1) 
character back into input stream ungetc push ............. eats iat en oats ungetc(3S) 
pseudo-random numbers generate uniformly distributed ........000. ee drand48(3C) 
report repeated lines in a file uniq ......... Lie Maseeae peiaiaeatet at ataan tae uniq(1) 
make a_ unique file name mktemp ..:....... ee. mktemp(3C) 
CONVETSION PrOGrAM UNMIS oe ecceecetteeceeeeeeseeetereeessneneanees units(1) 
exercise link and unlink system calls link oe link(1m) 
remove directory entry UNNINK ce eeeceeeeeeeetereeereeeeeeees unlink(2) 
unmount a file system umourt ............... umount(2) 
umount unmount a file system oe umount(2s) 
suspend process until signal pause .... ee pause(2) 
times of a file touch update access and modification ............ touch(1) 
linear search and update Isearch 0... cece ee ctetetees lsearch(3C) 
update super-block SYNC ow. ee sync(2) 
update the super block sync ............... sync(1) 
programs make maintain, update, and regenerate groups of ......... make(1) 
specify what todo upon receipt of a signal signal ............... signal(2) - | 
SUMMariZe diSK USAGE GU oo... cc eeecectneeetteteeeaeeenaneaes du(1) ae 
GU SUMMANZE -CISK: “USAGE: icin, casa ircctgestinsecaiytiagamcisian maces du(8) 
Stat statistical network useful with graphical commands ............ stat(1) 
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j generate disk accounting data by user ID diskusg diskusg  .................08. diskusg(1m) 
print user and group IDs and names id ......... id(1) 
set user and group IDs setuid .......00. setuid(2) 
user crontab file crontab ...... crontab(1) 
get character login name of the user CUSETID ow. ect creeeees cuserid(3S) 
user environment environ 0.00... environ(5) 
get and set user limits UliMit 00 een ulimit(2) 
return login name of user logname ....... eee logname(3X) 
become super-user or another USEF SU ooo... cece sete et cette seeeeenns su(1) 
in the utmp file of the current user ttyslot find the slot 0.0.0.0. ttyslot(3C) 
getuid get real and effective user, and real and effective ....000000000.... getuid(2s) 
and effective group get real user, effective user, real group, ............. getuid(2) 
group get real and effective, user, real and effective ...........00.. getuid(2) 
group get real user, effective user, real group, and effective ............... getuid(2) 
send mail to users or read mail mail .............00 en. mail(1) 
write to all users Wall ooo... ec ecece cesar eeseeenes wall(1m) 
editor (variant of ex for casual users) edit text oo... eeceecceee eens edit(1) 
fuser identify processes using a file or file structure 00... fuser(1m) 
Statistics ustat get file system oe ustat(2s) 
get file system Statistics UStat eee seccerecererteeeenney ustat(2) 
graphical utilities gutil oo. ce ereeeeen gutil(1) 
identical mirutil utility for Connecting tWo ....... ee mirutil(1m) 
access and modification times utime set file oo... eects utime(2) 
utmp utmp and wtmp entry formats ................ utmp(4) 
access utmp file entry getut 0.0... eee getut(3C) 
a. ttyslot find the slot in the utmp file of the current user ................... ttyslot(3C) 
( : for the uucp system uucico file transport program |... uucico(1m) 
re uucp spool directory Clean-UP UUCIEAN oo... ec ccccceceeeeetseeteeseceteee uuclean(1m) 
| monitor uucp network UUSUD ...... ee uusub(1m) 
uuclean uucp spool directory clean-up .............. uuclean(1m) 
control uustat uucp Status inquiry and job ........ uustat(1) 
file transport program for the UuCP SYSt@M UUCICO ......... eee uucico(1m) 
UNIX system to UNIX system COPY UUCP oo. cccccecceeeerceteeeerntneseeeennes uucp(1) 
encode/decode a binary file for/ uuencode,uudecode ......... ees uuencode(1c) 
Status inquiry and job control UuStat UUCD oon... cette eeeteee uustat(1) 
monitor UUCp Network UUSUD ooo... cece eee ettreteeertnetetees uusub(1m) 
UNIX-to-UNIX system file copy UUtO PUDIIC 0. ecetteeeeen uuto(1) 
system command execution uux UNIX-to-UNIX oo ee uux(1) 
requests uuxqt execute remote command ........... uuxqt(1m) 
validate SCCS file Val oo ic iiccccesseeccseensseseeeseceneennady val(1) 
validate SCCS§ file val... val(1) 
return integer absolute ValUC ADS oo... ccccccetseeeesenneeeen abs(3C) 
Fortran absolute value€ ADS ooo... cccceceeestteeeeeeeeteees abs(3F) 
return value for environment name getenv ...... getenv(3C) 
ceiling, remainder, absolute value functions floor floor, ................008. floor(3M) 
tell report the current value of a file pointer... ee, tell(2s) 
change or add_ value to environment putenv |... putenv(3C) 
Provide truth ValUCS TrU@ ...... ce eeeeeereeeereeeeeeans true(1) 
machine-dependent values valu@S uu... eee ee cette values(5) 
machine-dependent values values ........ Hai cea aes atee tae dsneneaatiecsh tie sStaaags: values(5) 
_ print formatted output of a varargs argument list vprintf .........0..00.0. vprintf(3S) 
oe handle variable argument liSt V@rargs 0.0.0... eee teteeeeeertntteaeeeeees varargs(5) 
y handle variable argument list varargs ................ varargs(5) 
return Fortran environment variable getenv 0.0... cece ees getenv(3F) 
VEFSION CORIO!” VO sereatstncpecivetanccesntichenchistassdiaatsioancehces ve(1) 
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get option letter from argument vector getopt 00.0... eee ceeeeenee getopt(3C) { 
verify program assertion assert .............. assert(3X) | 
—— VEFSION COMPO] VC oc. cece ccceseeeeeeseeeeeeens ve(1) 
geta version of a SCCS file get ...... a, get(1) 
compare two versions of an SCCS file sccsdiff ........... sccsdiff(1) 
display editor based on ex vi screen-oriented (visual) ...0..0. vi(1) 
mv a macro package for Making VIEW GrapNS 2.0... cree eeeeees mv(7) 
mmt typeset documents, viewgraphs, and slides... mmt(1) 
file systems with label checking volcopy COpy ............ cece neereees volcopy(1m) 
format of system VOIUME FS oo... eee terre serene fs(4) 
output of a varargs argument list vprintf print formatted 0... ee vprintf(3S) 
terminate wait wait for child process to stop or ............. wait(2) 
- await completion of proceSS Walt cette ceeceeenteneeereeraaeeeeeey wait(1) 
walk a file tree ftW ooo... ccc cceeecseereees ftw(3C) 
write to all users Wall 0... ee cccecee een tettnteeeeeeeees wail(im) 
WOId COUNL: (WG: fesse cocks oiunheeate idea eaten wc(1) 
crashes crash what to do when the system .......0...00..... crash(8) 
who is doing what whodo ............. whodo(1m) 
who is on the system who ......... who(1) 
who is doing what WhOdO oon... cece cerreertneeertaeeeren whodo(1m) 
profile within a function prof ............ ee prof(5) 
| WOId COUNT WC oo... cccccetteceeecee teentens wc(1) 
get character or word from a stream getc .......0. getc(3S) 
guess the word hangman .......... ee eeneeees hangman(6) 
put character or word on a Stream pulC ....... putc(3S) 
find hyphenated words hyphen ooo... eres eteeen hyphen(1) 
change working directory cd .......... Se eee eee cd(1) | 
change working directory Chdir .............cc ee chdir(2) 
get path-name of current working directory getewd ................06. getcwd(3C) 
working directory name pwd .................. pwd(1) 
chdir change working directory .......... ce eeeeees chdir(2s) 
write write On a file oo... eet cee write(2s) 
putpwent write password file entry ........0... 0. putpwent(3C) 
write to all users Wall .......... cee wail(1m) 
write ON a fIIE WHITE cece seeeaaneetenes alee: write(2) 
on the other terminal and exits. write EQT oo... ccccecessteeresseeeens write(1) 
open for reading or wWTitINg OPEN oo... eee ee rteeees open(2) 
open for reading OF WYITING 0... cece ceceecetetteeeeeeeeereteetens open(2s) 
utmp and wtmp entry formats utmp ............0. utmp(4) 
the game of hunt-the-WUMPUS WUMD 0.0.0... ccccceeennteeeteneeeentrteeseaaes wump(6) 
for the Xerox 9700 printer x9700 prepare nroff documents ............. x9700(1) 
list(s) and execute command xargs construct argument ......... xargs(1) 
yacc yet another compiler-compiler ................ yacc(1) 
= 
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NAME 


; 


intro — introduction to commands and application programs 


DESCRIPTION 


This section describes, in alphabetical order, publicly-accessible 

commands. Certain distinctions of purpose are made in the head- 

ings: 

(1) Commands of general utility. 

(1C) |©Commands for communication with other systems. 

(1G) | Commands used prinvarily for graphics and computer-aided 
design. 


COMMAND SYNTAX 


Unless otherwise noted, commands described in this section accept 
options and other arguments according to the following syntax: 


name [option(s )]| [cmdarg(s)] 


where: 
name The name of an executable file. 
option ~ noargletter (s ) or, 


— argletter <> optarg 
where <> is optional white space. 


noargiletter A single letter representing an option without an argu- 


ment. 

argletter A single letter representing an option requiring an 
argument. 

optarg Argument (character string) satisfying preceding 

| _ argietter . 

cmdarg Path name (or other command argument) not begin- 
ning with — or, — by itself indicating the standard 
input. 

SEE ALSO 
getopt(1). 


exit(2), wait(2), getopt(3C) in the Sys5 UNIX Programmer Reference 
Manual. 


DIAGNOSTICS 


Page 1 


Upon termination, each command returns two bytes of status, one 
supplied by the system and giving the cause for termination, and (in 
the case of “normal” termination) one supplied by the program (see 
wait (2) and exit (2)). The former byte is 0 for normal termination; 
the latter is customarily 0 for successful execution and non-zero to 
indicate troubles such as erroneous parameters, bad or inaccessible 
data, or other inability to cope with the task at hand. It is called 
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BUGS 


variously “exit code’, “exit status’, or “return code’, and is 
described only where special conventions are involved. ( 


Regretfully, many commands do not adhere to the aforementioned 
syntax. 


WARNINGS 


Some commands produce unexpected results when processing files 
containing null characters. These commands often treat text input 
lines as strings and therefore become confused upon encountering 
a null character (the string terminator) within a line. 
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_ NAME 


300, 300s — handle special functions of DAS! 300 and 300s termi- 
nals 


SYNOPSIS 
300 [ +12 ][—n] [ -dtl.c} 


300s [| +12] [ -n ] [ -d tlc ] 
300S [| +12] [ -n ] [ -d tlc ] 


DESCRIPTION 

The 300 command supports special functions and optimizes the use 
of the DASI 300 (GSI 300 or DTC 300) terminal; 300s performs the 
same functions for the DAS! 300s (GSI 300s or DTC 300s) terminal. 
It converts half-line forward, half-line reverse, and full-line reverse 
motions to the correct vertical motions. It also attempts to draw 
Greek letters and other special symbols. It permits convenient use 
of 12-pitch text. It also reduces printing time 5 to 70%. The 300 
command can be used to print equations neatly, in the sequence: 


neqn file ... | nroff | 300 


WARNING: if your terminal has a PLOT switch, make sure it is turned 
on before 300 is used. 


The behavior of 300 can be modified by the optional flag arguments 
to handle 12-pitch text, fractional line spacings, messages, and 
delays. 


+12 permits use of 12-pitch, 6 lines/inch text. DAS! 300 termi- 
nals normally allow only two combinations: 10-pitch, 6 
lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12- 
pitch, 6 lines per inch combination, the user should turn 

- the PITCH switch to 12, and-use the + 12. aption. 


=n controls the size of half-line spacing. A half-line is, by 
default, equal to 4 vertical plot increments. Because each 
increment equals 1/48 of an inch, a 10-pitch line-feed 
requires 8 increments, while a 12-pitch line-feed needs 
only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of sub- 
scripts and superscripts. For example, nroff half-lines — 
could be made to act as quarter-lines by using -2 . The 
user could also obtain appropriate half-lines for 12-pitch, 8 
lines/inch mode by using the option -—3 alone, having set 
the PITCH switch to 12-pitch. 
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-—dt,/,c controls delay factors. The default setting is —d3,90,30 . 
DAS! 300 terminals sometimes produce peculiar output, 
when faced with very long lines, too many tab characters, 
or long strings of blankless, non-identical characters. One 
null (delay) character is inserted in a line for every set of ¢ 
tabs, and for every contiguous string of c non-blank, non- 
tab characters If a line is longer than / bytes, 1+ (total 
length)/20 nulls are inserted at the end of that line. Items 
can be omitted from the end of the list, implying use of the 
default values. Also, a value of zero for t (c) results in 
two null bytes per tab (character). The former may be 
needed for C programs, the latter for files like 
/etc/passwd . Because terminal behavior varies according 
to the specific characters printed and the load on a sys- 
tem, the user may have to experiment with these values 

to get correct output. The —d option exists only as a last 
resort for those few cases that do not otherwise print 
properly. For example, the file /etc/passwd may be 
printed using —d3,30,5 . The value -d0,1 is a good one to 
use for C programs that have many levels of indentation. 


Note that the delay control interacts heavily with the pre- 


vailing carriage return and line-feed delays. The stty (1) — 
modes nlO cr2 or nlO cr3 are recommended for most ~ 


uSeS. 


The 300 command can be used with the nroff -—s flag or .rd 
requests, when it is necessary to insert paper manually or change 
fonts in the middle of a document. Instead of hitting the return key 
in these cases, you must use the line-feed key to get any response. 


In many (but not all) cases, the following sequences are equivalent: 


nroff —T300 files... and nroff files... | 300 
nroff -T300—12 files... and _ nroff files... | 300 +12 


The use of 300 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move- 
ment optimization of 300 may produce better-aligned output. 


The neqn names of, and resulting output for, the Greek and special 
characters supported by 300 are shown in greek (7). 


450(1), eqn(1), graph(1G), mesg(1), nroff(1), stty(1), tabs(1), tol(1), 
tplot(1G), greek(1). 
Sys5 UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. 


Some special characters cannot be correctly printed in column 1 
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- because the print head cannot be moved to the left from there. 
( If your output contains Greek and/or reverse line-feeds, use a 
—- friction-feed platen instead of a forms tractor; although good enough 
for drafts, the latter has a tendency to slip when reversing direction, 
distorting Greek characters and misaligning the first line of text after 
one or more reverse line-feeds. 
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4014(1) 
NAME : 

4014 — paginator for the TEKTRONIX 4014 terminal ‘ 
SYNOPSIS 


DESCRI 


4014[-t]{[-n][-cN][-pL]|[ file ] 


PTION 

The output of 4074 is intended for a TEKTRONIX 4014 terminal: 
4014 arranges for 66 lines to fit on the screen, divides the screen 
into N columns, and contributes an eight-space page offset in the 
(default) single-column case. Tabs, spaces, and backspaces are 
collected and plotted when necessary. TELETYPE® Model 37 half- 
and reverse-line sequences are interpreted and plotted. At the end 
of each page. 4074 waits for a new-line (empty line) from the key- 
board before continuing on to the next page. In this wait state, the 
command !cmd will send the cmd to the shell. 


The command line options are: 


—t Do not wait between pages (useful for directing output into a 
file). 

-n Start printing at the current cursor position and never erase 
the screen. 


-~cN Divide the screen into N columns and wait after the last” 


column. 


-pL Set page length to L ; L accepts the scale factors i (inches) 
and | (lines); default is lines. 


SEE ALSO 
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pr(1), te(1), troff(1). 
Sys5 UNIX Documenter's Workbench Software Introduction and 
Reference Manual. 
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.. NAME 
450 — handle special functions of the DASI 450 terminal 
SYNOPSIS 
450 
DESCRIPTION 


The 450 command supports special functions of, and optimizes the 
use of, the DAS! 450 terminal, or any terminal that is functionally 
identical, such as the DIABLO 1620 or XEROX 1700. It converts 
half-line forward, half-line reverse, and full-line reverse motions to 
the correct vertical motions. It also attempts to draw Greek letters 
and other special symbols in the same manner as 300 (7). Use 450 
to print equations neatly, in the sequence: 


neqn file ... | nroff | 450 


WARNING: make sure that the PLOT switch on your terminal is ON 
before 450 is used. The SPACING switch should be put in the 
desired position (either 10- or 12-pitch). In either case, vertical 
spacing is 6 lines/inch, unless dynamically changed to 8 lines per 
inch by an appropriate escape sequence. 


Use 450 with the nroff —s flag or .rd requests when it is necessary 
to insert paper manually or change fonts in the middle of a docu- | 
ment. Instead of hitting the return key in these cases, you must use 
the line-feed key to get any response. 


In many (but not all) cases, the use of 450 can be eliminated in 
favor of either nroff —T450 files... or nroff -T450-—12 files... 


The use of 450 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move- 
ment optimization of 450 may produce better-aligned output. 


The neqn names of, and resulting output for, the Greek and special 
characters supported by 450 are shown in greek (7). 


SEE ALSO 


BUGS 
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300(1), eqn(1), graph(1G), mesg(1), nroff(1), stty(1), tabs(1), tbl(1), 
tplot(1G), greek(1). 
Sys5 UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. 


Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a 
friction-feed platen instead of a forms tractor; although good enough 
for drafts, the latter has a tendency to slip when reversing direction, 
distorting Greek characters and misangning the first line of text after 
one or more reverse line-feeds. 
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_NAME | 
) acctcom — search and print process accounting file(s) 
~~" SYNOPSIS 
acctcom [[options][file]] ... 
DESCRIPTION 


Acctcom reads file , the standard input, or lusr/adm/pacct , in the 
form described by acct (4) and writes selected records to the stan- 


dard output. Each record represents the execution of one process. 


The output shows the COMMAND NAME , USER , TTYNAME , START 
TIME , END TIME , REAL (SEC) , CPU (SEC) , MEAN SIZE(K) , and 
optionally, F (the fork / exec flag: 1 for fork without exec), STAT (the 
system exit status), HOG FACTOR, KCORE MIN, CPU FACTOR, 
CHARS TRNSFD, and BLOCKS READ (total blocks read and written). 


The command name is prepended with a # if it was executed with 
super - user privileges. If a process is not associated with a known 
terminal, a ? is printed in the TTYNAME field. 


If no files are specified, and if the standard input is associated with 
a terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read; otherwise, the standard input is read. 


If any file arguments are given, they are read in their respective — 
order. Each file is normally read forward, i.e., in chronological order 
by process completion time. The file /usr/adm/pacct is usually the 
current file to be examined; a busy system may need several such 
files of which all but the current file are found in /usr/adm/pacct? . 
The options are: 


~a Show some average statistics about the processes 
selected. The statistics will be printed after the output 
records. 

—b Read backwards, showing latest commands first. This 
option has no effect when the standard input is read. 

—f Print the fork / exec flag and system exit status 
columns in the output. 

—h Instead of mean memory size, show the fraction of 


total available CPU time consumed by the process dur- 
ing its execution. This “hog factor’ is computed as: 
(total CPU time)/(elapsed time). 
—| Print columns containing the !/O counts in the output. 


—k Instead of memory size, show total kcore-minutes. 
-m Show mean core size (the default). 
—r | Show CPU factor (user time/(system-time + user- 
; time). 
—t Show separate system and user CPU times. 
—V Exclude column headings from the output. 
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—I fine Show only processes belonging to terminal /dev/line. 
—u user Show only processes belonging to user that may bq 

specified by: a user ID, a login name that is then con- | 
verted to a user ID, a # which designates only those 
processes executed with super - user privileges, or ? 
which designates only those processes associated 
with unknown user IDs. 

-—g group Show only processes belonging to group . The group 
may be designated by either the group ID or group 
name. 

—s time Select processes existing at or after time , given in the 
format hr [: min [: sec ]]. 

—e time Select processes existing at or before time . 

-—S time Select processes starting at or after fime . 

—E time Select processes ending at or before time . Using the 
same time for both -—S and —E shows the processes 
that existed at time . 

—n pattern Show only commands matching pattern that may be a 
regular expression as in ed (7) except that + means 
one or more occurrences. 

—q Do not print any output records, just print the average 
statistics as with the —a option. a 

—O ofile Copy selected process records in the input data format. 
to ofile ; supress standard output printing. 

-H factor Show only processes that exceed factor , where factor 
is the “hog factor” as explained in option -h above. 

—O sec Show only processes with CPU system time exceeding 
sec seconds. 

-~C sec show only processes with total CPU time, system plus 
user, exceeding sec seconds. 

-| chars Show only processes transferring more characters 
than the cut-off number given by chars . 

FILES 
/etc/passwd 
/usr/adm/pacct 
/etc/group 

SEE ALSO 
ps(1), su(1). | | 
acct(2), acct(4), utmp(4) in the Sys5 UNIX Programmer Reference 
Manual. | 
acct(1M), acctems(1M), acctcon(1M), acctmerg(1M), acctprc(1M), 


acctsh(1M), fwtmp(1M), runacct(1M) in the "Sys5 UNIX Administray” 
tor Reference Manual" . 
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Acctcom only reports on processes that have terminated; use ps 
(1) for active processes. If time exceeds the present time, then 
time is interpreted as occurring on the previous day. 
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NAME 
adb — absolute debugger | ( \ 
SYNOPSIS | 2 
adb [—w] [ objfil [ corfil ] ] 
DESCRIPTION 


Adb is a general purpose debugging program. It may be used to 
examine files and to provide a controlled environment for the execu- 
tion of UNIX system programs. 


Objfil is normally an executable program file, preferably containing a 
symbol table; if not then the symbolic features of adb cannot be used 
although the file can still be examined. The default for objfi! is a.out. 
Corfil is assumed to be a core image file produced after executing 
objfil ; the default for corfil is core . 


Requests to adb are read from the standard input and responses are 
to the standard output. If the —w flag is present then both objfil and 
corfil are created if necessary and opened for reading and writing so 
that files can be modified using adb . Adb ignores QUIT; INTERRUPT 
Causes return to the next adb command. 


In general requests to adb are of the form 
[address] [, count ] [command] [;] 


Address and count are expressions. If address is present, dot. is set 
to address. Initially it is set to 0. For most commands count 
specifies how many times the command will execute. The defaus J 


count is 1. 
The interpretation of an address depends on the context it is used in. 
lf a subprocess is being debugged then addresses are interpreted in 
the usual way in the address space of the subprocess. For further 
details of address mapping see ADDRESSES. 
EXPRESSIONS 
The value of dot. 
+ The value of dot incremented by the current increment. 
* The value of dot decremented by the current increment. 
7 The last address typed. 
integer | 
An octal number if integer begins with a 0; a hexadecimal 
number if preceded by # ; otherwise a decimal number. 
integer fraction 
A 32-bit floating point number. 
‘cccc’ The ASCIl value of up to 4 characters. A \ may be used to 
escape a’ 
< name f a 


The value of name, which is either a variable name or a regis. 
ter name. Adb maintains a number of variables (see VARIN 
ABLES) named by single letters or digits. If name is a register 
name then the value of the register is obtained from the sys- 
tem header in corfil. The register names are rQ... ri1 sp pe ps 
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fp ap for the VAX and ro... r5 sp pe ps for the PDP-11. 


( symbol 

ee. A symbol is a sequence of upper or lower case letters, under- 
scores or digits, not starting with a digit. The value of the 
symbol is taken from the symbol table in objfi! . An initial _ or 

| ~ will be prefixed to symbo/ if needed. 

_ symbol 

In C, the ‘‘true name’”’ of an external symbol begins with _. It 
may be necessary to utter this name to distinguish it from 
internal or hidden variables of a program. 


routine name 
The address of the variable name in the specified C routine. 
Both routine and name are symbols . |lf name is omitted the 
value is the address of the most recently activated C stack 
frame corresponding to routine. 


(exo) The value of the expression exp . 
Monadic operators: 
exp The contents of the location addressed by exp in corfil 


@exp The contents of the location addressed by exp in objfil 


( ~*~ —exp Integer negation. 
cai ~exp Bitwise complement. 


Dyadic operators are left associative and are less binding than 
monadic operators. 


e? +e2 
Integer addition. 


el —e2 
Integer subtraction. 
e?+e2 Integer multiplication. 


el %e2 
Integer division. 


e? &e2 Bitwise conjunction. 
e? je2 Bitwise disjunction. 


el #e2 
E1 rounded up to the next multiple of e2 . 


COMMANDS 
Most commands consist of a verb followed by a modifier or list of 
modifiers. The following verbs are available. (The commands ? and / 
( may be followed by « ; see ADDRESSES for further details.) 


?f Locations starting at address in objfil are printed according to 
the format f. dot is incremented by the sum of the increments 
for each format letter (q.v.). 
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If Locations starting at address in corfi! are printed according to 
the format f and dot is incremented as for ?. 


{ 
=f The value of address itself is printed in the styles indicated by 
the format f . (For i format ? is printed for the parts of the 
- instruction that reference subsequent words.) 


A format consists of one or more characters that specify a style of 
printing. Each format character may be preceded by a decimal 
integer that is a repeat count for the format character. While step- 
ping through a format, dot is incremented by the amount given for 
each format letter. If no format is given then the last format is used. 
The format letters available are as follows: 


o 2 


Q0onN*cexxOgn2 O20 
—t ah =t OO BS DP HP HH APD 


= 


Print 2 bytes in octal. All octal numbers output by adb 
are preceded by 0. 

Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. : 
Print double floating point. — 
Print the addressed byte in octal. A 
Print the addressed character. - 
Print the addressed character using the following 
escape convention. Character values 000 to 040 are 
printed as @ followed by the corresponding character 
in the range 0100 to 0140. The character @ is printed 
as @@. 

Print the addressed characters until a zero character is 
reached. 

Print a string using the @ escape convention. The 
value n is the length of the string including its zero 
terminator. 

Print 4 bytes in date format (see ctime (3C)). 

Print as PDP-11 instructions. The value n is the 
number of bytes occupied by the instruction. This 
style of printing causes variables 1 and 2 to be set to 
the offset parts of the source and destination, respec- 
tively. 

Print the value of dot in symbolic form. Symbols are 
checked to ensure that they have an appropriate type 
as indicated below. 


/ local or global data symbol 
? local or global text symbol 7 
= local or global absolute symbol ed 


Print the addressed value in symbolic form using the 
same rules for symbol lookup as a. 
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t 0 When preceded by an integer, tabs to the next 
appropriate tab stop. For example, 8t moves to the 
next 8-space tab stop. 


r 0 Print a space. 

n 0 Print a new-line. 

“" QO Print the enclosed string. 

: Dot is decremented by the current increment. Nothing 
iS printed. 

+ Dot is incremented by 1. Nothing is printed. 


- Dot is decremented by 1. Nothing is printed. 


new-line 
Repeat the previous command with a count of 1. 


[?/]l value mask 
Words starting at dot are masked with mask and compared 
with va/ue until a match is found. If L is used then the match 
is for 4 bytes at a time instead of 2. If no match is found then 
dot is unchanged; otherwise dot is set to the matched loca- 
tion. If mask is omitted then —1 is used. 


[?/|w value... - 
Write the 2-byte value into the addressed location. If the 
command is W , write 4 bytes. Odd addresses are not 
allowed when writing to the subprocess address space. 


[?/Jm b7 e7 f1[?/ 
New values for (67, e7, f1) are recorded. If less than three — 
expressions are given then the remaining map parameters are 
left unchanged. If the ? or / is followed by « then the second 
segment (b2,e2,f2) of the mapping is changed. If the list is 
terminated by ? or / then the file (ob/fif or corfil , respectively) 
is used for subsequent requests. (So that, for example, /m? 
will cause / to refer to obyfil .) 


>name : 
Dot is assigned to the variable or register named. 


! A shell is called to read the rest of the line following !. 


$modifier 

Miscellaneous commands. The available modifiers are: 

<f Read commands from the file f and return. 

>f Send output to the file f , which is created if it does 
not exist. 

r Print the general registers and _ the _ instruction 
addressed by pc. Dot is set to pc. 

f Print the floating registers in single or double length. If 


the floating point status of ps is set to double (0200 
bit) then double length is used anyway. 


b Print all breakpoints and their associated counts and 
commands. 
a ALGOL 68 stack backtrace. If address is given then it 


is taken to be the address of the current frame 
(instead of r4 ). If count is given then only the first 
count frames are printed. 
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c C stack backtrace. If address is given then it is taken 
as the address of the current frame (instead of r ). . 
C is used then the names and (16-bit) values of ak / 
automatic and static variables are printed for each 
active function. If count is given then only the first 
count frames are printed. 

& The names and values of external variables are 
printed. 

w Set the page width for output to address (default 80). 

s Set the limit for symbol matches to address (default 

255). . 

All integers input are regarded as octal. 

Reset integer input as described in EXPRESSIONS. 

Exit from adb . 

Print all non-zero variables in octal. 

Print the address map. 


3<2 a0 


wmodifier | 
Manage a subprocess. Available modifiers are: 


be Set breakpoint at address . The breakpoint is executed 
count -—7 times before causing a stop. Each time the 
breakpoint is encountered the command c is exe- 
cuted. If this command sets dot to zero then the 
breakpoint causes a stop. 


d Delete breakpoint at address . ( ‘ 


Run objfil as a subprocess. If address is given expli- ~~ 
citly then the program is entered at this point; other- 
wise the program is entered at its standard entry point. 
The value count specifies how many breakpoints are 

to be ignored before stopping. Arguments to the sub- 
process may be supplied on the same line as the com- 
mand. An argument starting with < or > causes the 
Standard input or output to be established for the 
command. All signals are turned on on entry to the 
subprocess. 


cs The subprocess is continued with signal s (see signal 
(2)). lf address is given then the subprocess is contin- 
ued at this address. If no signal is specified then the 
signal that caused the subprocess to stop is sent. 
Breakpoint skipping is the same as forr. 


ss As for c except that the subprocess is single stepped 
count times. If there is no current subprocess then 
objfil is run as a subprocess as forr. In this case no 
signal can be sent; the remainder of the line is treated 
as arguments to the subprocess. 


k The current subprocess, if any, is terminated. a 
( 
Attach to another running process. The syntax is. _/ 
PID:p. 
@ Detach from process attached to with :p. 
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| VARIABLES 
ie Adb provides a number of variables. Named variables are set initially 
by adb but are not used subsequently. Numbered variables are 
reserved for communication as follows. 


0 The last value printed. 
1 The last offset part of an instruction source. 
2 The previous value of variable 1. 


On entry the following are set from the system header in the corfi/ . If 
corfil does not appear to be a core file, then these values are set 


from objfil . 

b The base address of the data segment. 
d The data segment size. 
e The entry point. 
m The ‘‘magic’” number (0405, 0407, 0410 or 0411). 
s The stack segment size. 
t The text segment size. 

ADDRESSES 


The address in a file associated with a written address is determined 
by a mapping associated with that file. Each mapping is represented 
by two triples (67, e7, ff) and (b2, e2, f2) and the file address 
corresponding to a written address is calculated as follows: 


b1 < address < e171 => file address = address + f1—b1 


( ; otherwise 
ae b2 < address < e2 => file address = address + f2-b2, 


otherwise, the requested address is not legal. In some cases (e.g., 
for programs with separated | and D space) the two segments for a 
file may overlap. If a ? or / is followed by an * then only the second 
triple is used. 


The initial setting of both mappings is suitable for normal a.out and 
core files. If either file is not of the kind expected then, for that file, 
b1 is set to 0, e7 is set to the maximum file size and f7 is set to 0; in 
this way the whole file can be examined with no address translation. 


In order for adb to be used on large files all appropriate values are 
kept as signed 32-bit integers. 


FILES 
/dev/mem 
/dev/swap 
a.out 
core 


SEE ALSO 
ptrace(2), a.out(4), core(4) in the Sys5 UNIX Programmer Reference 
Manual. 


“DIAGNOSTICS 
( | ‘‘Adb’’ when there is no current command or format. Comments 
about inaccessible files, syntax errors, abnormal termination of com- 
mands, etc. Exit status is 0, unless last command failed or returned 


nonzero status. 


eed 
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BUGS 


Page 7 


A breakpoint set at the entry point is not effective on initial entry tr 
the program. ‘ 


When single stepping, system calls do not count as an executed 
instruction. 


Local variables whose names are the same as an external variable 
may foul up the accessing of the external. 


On the VAX, there is some confusion about 2-byte versus 4-byte 
quantities. 
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NAME 


admin — create and administer SCCS files 


SYNOPSIS 


Nevlh 


admin [-n] [-i[name]]  [-rrel] [-t[namel]]  [-fflag[flag-val]] 
[—dflag[flag-val]] [—alogin] [—elogin] [—m[mrlist]] [-y[comment]] [—h] 
[—z] files | 


DESCRIPTION 


Paae 1 


Admin is used to create new SCCS files and change parameters of 
existing ones. Arguments to admin, which may appear in any order, 
consist of keyletter arguments, which begin with —, and named files 
(note that SCCS file names must begin with the characters s.). If a 
named file does not exist, it is created, and its parameters are initial- 
ized according to the specified keyletter arguments. Parameters not 
initialized by a keyletter argument are assigned a default value. Ifa 
named file does exist, parameters corresponding to specified 
keyletter arguments are changed, and other parameters are left as 
is. 2 


If a directory is named, admin behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files 
(last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of — is given, the | 
standard input is read; each line of the standard input is taken to be 
the name of an SCCS file to be processed. Again, non-SCCs files 
and unreadable files are silently ignored. 


The keyletter arguments are as follows. Each is explained as 
though only one named file is to be processed since the effects of 
the arguments apply independently to each named file. 


—n This keyletter indicates that a new SCCS file 
is to be created. 


~—i[name] The name of a file from which the text for a 
new SCCS file is to be taken. The text consti- 
tutes the first delta of the file (see -r keyletter 
for delta numbering scheme). If the i 
keyletter is used, but the file name is omitted, 
the text is obtained by reading the standard 
input until an end-of-file is encountered. If 
this keyletter is omitted, then the SCCS file is 
created empty. Only one SCCS file may be 
created by an admin command on which the 
i keyletter is supplied. Using a single admin 
to create two or more SCCS files requires that 
they be created empty (no —i keyletter). Note 
that the —i keyletter implies the —n keyletter. 
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—trel The release into which the initial delta is ~ 
inserted. This keyletter may be used only ( 
the -i keyletter is also used. If the -tr 
keyletter is not used, the initial delta is 
inserted into release 1. The level of the initial 
delta is always 1 (by default initial deltas are 
named 1.1). 


~—tiname] The name of a file from which descriptive text 
for the SCCS file is to be taken. If the -t 
keyletter is used and admin is creating a new 
SCCS file (the -—n and/or -i keyletters also 
used), the descriptive text file name must 
also be supplied. In the case of existing 
SCCS files: (1) a -t keyletter without a file 
name causes removal of descriptive text (if 
any) currently in the SCCS file, and (2) a -t 
keyletter with a file name causes text (if any) 
in the named file to replace the descriptive 
text (if any) currently in the SCCS file. 


—fflag This keyletter specifies a flag, and, possibly, 
a value for the flag, to be placed in the SCCS ~~ 
file. Several f keyletters may be supplied on‘. 
a single admin command line. The allowable 
flags and their values are: 


b Allows use of the —b keyletter on a get (7) 
command to create branch deltas. 


cceil The highest release (i.e., “ceiling’), a number 
less than or equal to 9999, which may be 
retrieved by a get (1) command for editing. 
The default value for an unspecified ¢€ flag is 
9999. 


ffloor The lowest release (i.e., “floor’), a number 
greater than O but less than 9999, which may 
be retrieved by a get (7) command for edit- 
ing. The default value for an unspecified f 
flag is 1. 


dsiD The default deita number (SID) to be used by 
a get (1) command. 


i[str] Causes the "No id keywords (ge6)" message 
issued by get (7) or delta (1) to be treated as /* 
a fatal error. In the absence of this flag, the \__/ 
message is only a warning. The message is 
issued if no SCCS identification keywords 
(see get (1)) are found in the text retrieved or 
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a stored in the SCCS file. If a value is supplied, 

} the keywords must exactly match the given 

string, however the string must contain a key- 
word, and no embedded newlines. 


j Allows concurrent get (17) commands for edit- 
ing on the same SID of an SCCS file. This 
allows multiple concurrent updates to the 
same version of the SCCS file. 


llist A list of releases to which deltas can no 
longer be made (get —e against one of these 
“locked” releases fails). The /ist has the fol- 
lowing syntax: 


<list> ::= <range> | <list> , <range> 
<range> ::= RELEASE NUMBER | a 


The character a in the list is equivalent to 
specifying ail releases for the named SCCS 


file. 
n Causes delta (1) to create a “null” delta in 
each of those releases (if any) being skipped 
co; when a delta is made in a new release (e.g., 
( J in making delta 5.1 after delta 2.7, releases 3 


and 4 are skipped). These null deltas serve 
as “anchor points” so that branch deltas may 
later be created from them. The absence of 
this flag causes skipped releases to be non- 
existent in the SCCS file, preventing branch 
deltas from being created from them in the 
future. 


qtext User definable text substituted for all 
occurrences of the %Q% keyword in SCCS 
file text retrieved by get (7). 


mmod Module name of the SCCS file substituted for 
all occurrences of the %M% keyword in SCCS 
file text retrieved by get (7). If the m flag is 
not specified, the value assigned is the name 
of the SCCS file with the leading s. removed. 


ttype Type of module in the SCCS file substituted 
for all occurrences of %Y% keyword in SCCS 

a file text retrieved by get (7). 
( v[pgm] 


Causes delta (7) to prompt for Modification 
Request (MR) numbers as the reason for 
creating a delta. The optional value specifies 
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the name of an MR number validity checking 
program (see delta (1)). (If this flag is se{ 
when creating an SCCS file, the m_ keyletter 
must also be used even if its value is null). 


—dflag Causes removal (deletion) of the specified 
flag from an SCCS file. The —d keyletter may 
be specified only when processing existing 
SCCS files. Several ~d keyletters may be 
supplied on a single admin command. See 
the -f keyletter for allowable flag names. 


list A list of releases to be “unlocked”. See the 
—f keyletter for a description of the | flag and 
the syntax of a /ist. 


—alogin A login name, or numerical UNIX system 
group ID, to be added to the list of users 
which may make deltas (changes) to the 
SCCS file. A group ID is equivalent to specify- 
ing all fogin names common to that group ID. 
Several a keyletters may be used on a single 
admin command line. As many fogins, or _ 
numerical group IDs, as desired may be oy” > 
the list simultaneously. If the list of users is. _/ 
empty, then anyone may add deltas. If login 
or group ID is preceded by a ! they are to be 
denied permission to make deltas. 


—e/login A login name, or numerical group ID, to be 
erased from the list of users allowed to make 
deltas (changes) to the SCCS file. Specifying 
a group ID is equivalent to specifying all fogin 
names common to that group ID. Several e 
keyletters may be used on a single admin 
command line. 


-y[comment| The comment text is inserted into the SCCS 
file as a comment for the initial delta in a 
manner identical to that of delta (1). Omis- 
sion of the —y keyletter results in a default 
comment line being inserted in the form: 


date and time created YY / MM / DD HH : MM 
: SS by login — 


The —y keyletter is valid only if the ~i and/or” > 
—n keyletters are specified (i.e., a new SCCS\ | 
file is being created). 
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FILES 
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—m([mriist] The list of Modification Requests (MR) 
numbers is inserted into the SCCS file as the 
reason for creating the initial delta in a 
manner identical to delta (1). The v flag must 
be set and the MR numbers are validated if 
the v flag has a value (the name of an MR 
number validation program). Diagnostics will 
occur if the v flag is not set or MA validation 
fails. 


—h Causes admin to check the structure of the 
SCCS file (see sccsfile(5)), and to compare a 
newly computed check-sum (the sum of all 
the characters in the SCCS file except those 
in the first line) with the check-sum that is 
stored in the first line of the SCCS file. 
Appropriate error diagnostics are produced. 


This keyletter inhibits writing on the file, so 
that it nullifies the effect of any other 
keyletters supplied, and is, therefore, only 
meaningful when processing existing files. 


—Z The SCCS file check-sum is recomputed and | 
stored in the first line of the SCCS file (see —h 
, above). 


Note that use of this keyletter on a truly cor- 
rupted file may prevent future detection of the 
corruption. 


The last component of all SCCS file names must be of the form 
S.file-name. New SCCS files are given mode 444 (see chmod (1)). 
Write permission in the pertinent directory is, of course, required to 
create a file. All writing done by admin is to a temporary x-file, 
called x.file-name, (see get (1)), created with mode 444 if the 
admin command is creating a new SCCS file, or with the same 
mode as the SCCS file if it exists. After successful execution of 
admin, the SCCS file is removed (if it exists), and the x-file is 
renamed with the name of the SCCS file. This ensures that changes 
are made to the SCCS file only if no errors occurred. 


It is recommended that directories containing SCCS files be mode 
755 and that SCCS files themselves be mode 444. The mode of the 
directories allows only the owner to modify SCCS files contained in 
the directories. The mode of the SCCS files prevents any modifica- 
tion at all except by SCCS commands. 


If it should be necessary to patch an SCCS file for any reason, the 
mode may be changed to 644 by the owner allowing use of ed (7). 
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Care must be taken! The edited file should always be processed by 
an admin —h to check for corruption followed by an admin -z to 
generate a proper check-sum. Another admin —h is recommended 
to ensure the SCCS file is valid. 


Admin also makes use of a transient lock file (called z.file-name), 
which is used to prevent simultaneous updates to the SCCS file by 
different users. See get (7) for further information. 


SEE ALSO 7 
delta(1), ed(1), get(1), help(1), prs(1), what(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
Use help (1) for explanations. 
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ar — archive and library maintainer for portable archives 


ar key [ posname ] afile [name] ... 


DESCRIPTION 


Page 1 


The Ar command maintains groups of files combined into a single 
archive file. Its main use is to create and update library files as 
used by the link editor. It can be used, though, for any similar pur- 
pose. The magic string and the file headers used by ar consist of 
printable ASCli characters. If an archive is composed of printable 
files, the entire archive is printable. 


When ar creates an archive, it creates headers in a format that is 
portable across all machines. The portable archive format and 
structure is described in detail in ar (4). The archive symbol table 
(described in ar (4)) is used by the link editor (/d(1)) to effect multi- 
ple passes over libraries of object files in an efficient manner. An 
archive symbol table is only created and maintained by ar when 
there is at least one object file in the archive. The archive symbol 
table is in a specially named file which is always the first file in the 
archive. This file is never mentioned or accessible to the user. 
Whenever the ar (7) command is used to create or update the con- . 
tents of such an archive, the symbol table is rebuilt. The $s option 


described below will force the symbol table to be rebuilt. 


Key is an optional — , followed by one character from the set 
drqtpmx , optionally concatenated with one or more of vuaibcls . 
Afile is the archive file. The names are constituent files in the 
archive file. The meanings of the key characters are: 


d Delete the named files from the archive file. 


r Replace the named files in the archive file. If the optional 
character u is used with r , then only those files with dates 
of modification later than the archive files are replaced. If 
an optional positioning character from the set abi is used, 
then the posname argument must be present and specifies 
that new files are to be placed after (a) or before (b or i ) 
posname . Otherwise new files are placed at the end. 


q Quickly append the named files to the end of the archive 
file. Optional positioning characters are invalid. The com- 
mand does not check whether the added members are 
already in the archive. Useful only to avoid quadratic 
behavior when creating a large archive piece-by-piece. 


t Print a table of contents of the archive file. If no names are 
given, all files in the archive are tabled. If names are given, 
only those files are tabled. 
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p Print the named files in the archive. te 


m Move the named files to the end of the archive. If a pos — y 
tioning character is present, then the posname argument 
must be present and, as in r , specifies where the files are 


to be moved. 

x _—sExtract the named files. If no names are given, all files in 
the archive are extracted. In neither case does x alter the 
archive file. | 

v Give a verbose file-by-file description of the making of a 


new archive file from the old archive and the constituent 
files. When used with t , give a long listing of all information 
about the files. When used with x , Pieces: each file with a 
name. 


Cc Suppress the message that is produced by default when 
afile is created. 


| Place temporary files in the local current working directory, 
rather than in the directory specified by the environment 
variable TMPDIR or in the default directory /tmp - 


Ss Force the regeneration of the archive symbol table even i 
ar (1) is not invoked with a command which will modify th¢ 
archive contents. This command is useful to restore the\— 
archive symbol table after the strip (1) command has been 
used on the archive. 


FILES | 
/tmp/ar* temporaries 


SEE ALSO 
arcv(1), lorder(1), strip(1). 
tmpnam(3S), a.out(4), ar(4) in the Sys5 UNIX Programmer Refer- 
ence Manual. | 


NOTES 
This archive format is not the same as that of Sys3. 


BUGS 
If the same file is mentioned twice in an argument list, it may be put 
in the archive twice. 


September 29, 1986 Page 2 


ARCV(1) UNIX Sys5 ARCV(1) 


—~.. NAME 
—_ arcv — convert archive files from PDP-11 to common archive format 
SYNOPSIS 
arcv infile outfile 
DESCRIPTION 
Arcv converts source archive files from the Sys5 UNIX portable 
archive format. The input archive file infile is converted to an 
equivalent output archive file outfile . Note that there is no conver- 
sion of the members of the input archive file. 
FILES 
/tmp/arcvs 
SEE ALSO 
ar(1). 


ar(4) in the Sys5 UNIX Programmer Reference Manual. 
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" NAME 


/ 


as — common assembler 
SYNOPSIS 
as [—o objfile] (—-n] [-j] [—-m] [-R] [-r] [-[bw]] [-V] file-name 


DESCRIPTION 
The as command assembles the named file. The following flags 
may be specified in any order: 


q a 
bene 


-—O objfile Put the output of the assembly in objfile . By default, the 
output file name is formed by removing the .s suffix, if 
there is one, from the input file name and appending a .o 
suffix. 


-n Turn off long/short address optimization. By default, 
address optimization takes place. 


—j Invoke the long-jump assembler. The address optimiza- 
tion algorithm chooses between long and short address 
lengths, with short lengths chosen when possible. Often, 
three distinct lengths are allowed by the machine archi- 
tecture; a choice must be made between two of those 

ter lengths. When the two choices given to the assembler 

( ; exclude the largest length allowed, then some addresses ~ 
ad might be unrepresentable. The long-jump assembler will 

always have the largest length as one of its allowable 

choices. If the assembler is invoked without this option, 

and the case arises where an address is unrepresentable 

by either of the two allowed choices, then the user will be 

informed of the error, and advised to try again using the 


—j option. 

—m Run the m4 macro pre-processor on the input to the 
assembler. 

-R Remove (unlink) the input file after assembly is com- 
pleted. 

-f Place all assembled data (normally placed in the .data 


section) into the .text section. This option effectively dis- 
ables the .data pseudo operation. This option is off by 
default. 
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—[bwl] Create byte (b), halfword (w) or long (I) displacements fo: | 
undefined symbols. (An undefined symbol is a referencé 7 
to a symbol whose definition is external to the input file or 
a forward reference.) The default value for this option is 
long (1) displacements. | 
-V Write the version number of the assembler being run on 
the standard error output. 
FILES 
/usritmp: as[1-6]XXXXXX temporary files 
SEE ALSO 


Id(1), m4(4), nm(1), strip(4). 
a.out(4) in the Sys5 UNIX Programmer Reference Manual. 


WARNING 


BUGS 


If the -m (m4 macro pre-processor invocation) option is used, key- 
words for m4 (see m4(1)) cannot be used as symbols (variables, 
functions, labels) in the input file since m4 cannot determine which 
are assembler symbols and which are rea! m4 macros. 


Use the —b or —w option only when undefined symbols are known to 
refer to locations representable by the specified default SS Diane as 
ment. Use of either option when assembling a file containing j | 
reference to a symbol that is to be resolved by the loader can lead 
to unpredictable results, since the loader may be unable to place the 
address of the symbol into the space provided. © 


The .align assembler directive is not guaranteed to work in the .text 
section when optimization is performed. 


Arithmetic expressions may only have one forward referenced sym- 
bol per expression. 
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( ~~ NAME 
_ asa — interpret ASA carriage control characters 


SYNOPSIS 


asa [files | 


DESCRIPTION 


Asa interprets the output of FORTRAN programs that utilize ASA car- 
riage control characters. It processes either the files whose names 
are given as arguments or the standard input if no file names are 
supplied. The first character of each line is assumed to be a control 
character; their meanings are: 


mes (blank) single new line before printing 
0 double new line before printing 

1 new page before printing 

+ overprint previous line. 


Lines beginning with other than the above characters are treated as 
if they began with ’ ’ . The first character of a line is not printed. If 
any such lines appear, an appropriate diagnostic will appear on 
standard error. This program forces the first line of each input file to 
start on a new page. 


To view correctly the output of FORTRAN programs which use ASA 
carriage control characters, asa could be used as a filter thus: 


a.out | asa | Ip 
and the output, properly formatted and paginated, would be directed 
to the line printer. FORTRAN output sent to a file could be viewed 


by: 


asa file 


SEE ALSO 
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efl(1), £77(1), fsplit(1), ratfor(1). 
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at, batch — execute commands at a later time | | t ; Z 


SYNOPSIS 


at time [ date ] [ + increment | 
at -r job ... 
at -/ [ job... | 


batch 


DESCRIPTION 
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At and batch read commands from standard input to be executed at 
a later time. Af allows you to specify when the commands should 
be executed, while jobs queued with batch will execute when sys- 
tem load level permits. At -r removes jobs previously scheduled 
with at. The -l option reports all jobs scheduled for the invoking 
user. 


Standard output and standard error output are mailed to the user 
unless they are redirected elsewhere. The shell environment vari- 
ables, current directory, umask, and ulimit are retained when the 
commands are executed. Open file descriptors, es and priority 
are lost. 


Users are permitted to use at if their name appears in the file 
/usr/lib/cron/at.allow. if that file does not exist, the file——~ 
/usr/lib/cron/at.deny is checked to determine if the user should be 
denied access to at. If neither file exists, only root is allowed to sub- 

mit a job. If either file is at.deny, global usage is permitted. The 
allow/deny files consist of one user name per line. 


The time may be specified as 1, 2, or 4 digits. One and two digit 
numbers are taken to be hours, four digits to be hours and minutes. 
The time may alternately be specified as two numbers separated by 
a colon, meaning hour : minute . A suffix am or pm may be 
appended; otherwise a 24-hour clock time is understood. The suffix 
zulu may be used to indicate GMT. The special names noon , mid- 
night , now , and next are also recognized. 


An optional date may be specified as either a month name followed 
by a day number (and possibly year number preceded by an 
optional comma) or a day of the week (fully spelled or abbreviated 
to three characters). Two special “days”, today and tomorrow are 
recognized. If no date is given, today is assumed if the given hour 
is greater than the current hour and tomorrow is assumed if it is 
less. If the given month is less than the current month (and no i 
is given), next year is assumed. Z 


The optional increment is simply a number suffixed by one of ihe: 


May 22, 1985 


AT(1) UNIX Sys5 AT(1) 


following: minutes , hours , days , weeks , months , or years . 
(The singular form is also accepted.) 


Thus legitimate commands include: 


at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 


At and batch write the job number and schedule time to standard 
error. 


Batch submits a batch job. It is almost equivalent to “at now’, but 
not quite. For one, it goes into a different queue. For another, 
“at now” will respond with the error message too late. 


At -r removes jobs previously scheduled by at or batch . The job 
number is the number given to you previously by the at or batch 
command. You can also get job numbers by typing at -l. You can 
only remove your own jobs unless you are the super-user. 


EXAMPLES 
The at and batch commands read from standard input the com- 
os mands to be executed at a later time. Sh (7) provides different 
( | ways of specifying standard input. Within your commands, it may — 
be useful to redirect standard output. 


This sequence can be used at a terminal: 
batch | 
nroff filename >outtile 
<control-D> (hold down ‘control’ and depress 'D’) 


This sequence, which demonstrates redirecting standard error to a 
pipe, is useful in a shell procedure (the sequence of output redirec- 
tion specifications is significant): 

batch <<! 


nroff filename 2>&1 >outfile | mail loginid 
| 


To have a job reschedule itself, invoke at from within the shell pro- 
cedure, by including code similar to the following within the shell file: 
echo "sh shellfile" | at 1900 thursday next week 


( / /usr/lib/cron - main cron directory 
eee /usr/lib/cron/at.allow - list of allowed users 
/usr/lib/cron/at.deny - list of denied users 
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/ust/libicron/queue - scheduling information \ 
/usr/spool/crorvatjobs - spool area So 
SEE ALSO 
kill(1), mail(1), nice(1), ps(1), sh(1). | 
cron(1M) in the Sys5 UNIX Administrator Reference Manual. 
DIAGNOSTICS 
Complains about various syntax errors and times out of range. 
——, 
So 
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awk — pattern scanning and processing language 


SYNOPSIS 


awk [ -F c ] [ prog | [ parameters ] [ files ] 


DESCRIPTION 
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Awk scans each input file for lines that match any of a set of pat- 
terns specified in prog . With each pattern in prog there can be an 
associated action that will be performed when a line of a file 
matches the pattern. The set of patterns may appear literally as 
prog , or in a file specified as -f file . The prog string should be 
enclosed in single quotes (’) to protect it from the shell. 


Parameters, in the form x=... y=... etc., may be passed to awk. 


Files are read in order; if there are no files, the standard input is 
read. The file name — means the standard input. Each line is 
matched against the pattern portion of every pattern-action state- 
ment; the associated action is performed for each matched pattern. 


An input line is made up of fields separated by white space. (This 
default can be changed by using FS; see below). The fields are 
denoted $1 , $2, ...; $0 refers to the entire line. 


A pattern-action statement has the form: 
pattern { action } 


A missing action means print the line; a missing pattern always 
matches. An action is a sequence of statements. A statement can 
be one of the following: 


if ( conditional ) statement [ else statement | 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression | 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, new-lines, or right 
braces. An empty expression-list stands for the whole line. Expres- 
sions take on string or numeric values as appropriate, and are built 
using the operators + ,-,*,/,%, and concatenation (indicated 
by a blank). The C operators ++ ,—,+=,-=,*=,/=, and 
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%= are also available in expressions. Variables may be scalars, 
array elements (denoted x[i]) or fields. Variables are initialized to 
the null string. Array subscripts may be any string, not necessarily 
numeric; this allows for a form of associative memory. String con- 
stants are quoted ("). 


No 


The print statement prints its arguments on the standard output (or 
on a file if >expr is present), separated by the current output field 
separator, and terminated by the output record separator. The 
printf statement formats its expression list according to the format 
(see printf (3S)). 


The built-in function /ength returns the length of its argument taken 
as a string, or of the whole line if no argument. There are also 
built-in functions exp , log , sqrt , and int . The last truncates its 
argument to an integer; subsir(s, m,n) returns the n -character 
substring of s that begins at position m . The function sprintf ( fmt , 
expr, expr, ... ) formats the expressions according to the printf 
(3S) format given by fmt and returns the resulting string. 


Patterns are arbitrary Boolean combinations ( ! , ||, && , and 
parentheses) of regular expressions and relational expressions. _ 
Regular expressions must be surrounded by slashes and are as inj 
egrep (see grep (1)). |solated regular expressions in a pattern\_/ 
apply to the entire line. Regular expressions may also occur in rela- 
tional expressions. A pattern may consist of two patterns separated 

by a comma; in this case, the action is performed for all lines 
between an occurrence of the first pattern and the next occurrence 

of the second. 


A relational expression is one of the following: 


expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a 
matchop is either ~ (for contains ) or !' (for does not contain ). A 
conditional is an arithmetic expression, a relational expression, or a 
Boolean combination of these. 


The special patterns BEGIN and END may be used to capture control 
before the first input line is read and after the last. BEGIN must be 
the first pattern, END the last. 


A single character c may be used to separate the fields by starting 
the program with: — 


BEGIN{ FS =c} 
or by using the -Fc option. 
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ee 
( 4 


Other variable names with special meanings include NF, the number 
of fields in the current record; NR, the ordinal number of the current 
record; FILENAME, the name of the current input file; OFS, the output 
field separator (default blank); ORS, the output record separator 
(default new-line); and OFMT, the output format for numbers (default 
%.6g ). 


EXAMPLES 


Print lines longer than 72 characters: 
length = 72 
Print first two fields in opposite order: 
{ print $2, $1 5 
Add up first column, print sum and average: 
{s += $1} 
END { print “sum is", s, " average is", s/NR } 
Print fields in reverse order: 
{ for (i = NF; i > 0; —i) print $i } 
Print all lines between start/stop pairs: 
/Start/, ;stop/ 
Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 
Print file, filling in page numbers starting at 5: 
Page { $2 = n++; } 
{ print } 
command line: awk —f program n=5 input 


SEE ALSO 


BUGS 
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grep(1), lex(1), sed(1). 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


Sys5 UNIX Support Tools Guide. 


Input white space is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number add 0 to it; to force it 
to be treated as a string concatenate the null string ("") to it. 
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NAME | 7 
banner — make posters a 
SYNOPSIS | 
banner strings 
DESCRIPTION 7 
Banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. 
SEE ALSO 


echo(1). 
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|, NAME 
et basename, dirname — deliver portions of path names 


SYNOPSIS 
basename string [ suffix ] 
dirname string 


DESCRIPTION 
Basename deletes any prefix ending in / and the suffix (if present in 
String ) from string , and prints the result on the standard output. It 
is normally used inside substitution marks ( "+ +" ) within shell pro- 
cedures. | 


Dirname delivers all but the last level of the path name in string . 


EXAMPLES 
The following example, invoked with the argument 
/usr/src/cmd/cat.c , compiles the named file and moves the output 
to a file named cat in the current directory: 


cc $1 
mv a.out sbasename $1 “\.c’* 


7 The following example will set the shell variable NAME to 
( > /usr/src/cmd : 


NAME =< dirname /usr/src/cmd/cat.c* 


SEE ALSO 
sh(1). 


BUGS 
The basename of / is null and is considered an error. 
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NAME 
bar — Berkeley archive and library maintainer x“ 
SYNOPSIS 
bar key [ posname ] afile name ... 
DESCRIPTION | 


Bar maintains groups of files combined into a single archive file. Its 
main use is to create and update library files as used by the loader. 
It can be used, though, for any similar purpose. N.B: This version 
of bar uses a ASCll-format archive which is portable among the 
various machines running UNIX. Programs for dealing with older for- 
mats are available: see arcv(8). 


Key is one characier from the set drqtpmx, optionally concatenated 
with one or more of uvnbail. Afile is the archive file. The names are 
constituent files in the archive file. The meanings of the key charac- 


ters are: 
d Delete the named files from the archive file. 
r Replace the named files in the archive file. If the optional 


character u is used with r, then only those files with ‘last- 
modified’ dates later than the archive files are replaced. If _ 
an optional positioning character from the set abi is used,; 
then the posname argument must be present and specifies “—~ 
that new files are to be placed after (a) or before (b or i) 
posname. Otherwise new files are placed at the end. 


q Quickly append the named files to the end of the archive 
file. Optional positioning characters are invalid. The com- 
mand does not check whether the added members are 
already in the archive. Useful only to avoid quadratic 
behavior when creating a large archive piece-by-piece. 


t Print a table of contents of the archive file. If no names are 
given, all files in the archive are tabled. If names are given, 
only those files are tabled. 


p Print the named files in the archive. 


m Move the named files to the end of the archive. If a posi- 
tioning character is present, then the posname argument 
must be present and, as in r, specifies where the files are to 
be moved. 


x Extract the named files. If no names are given, all files in 
the archive are extracted. In neither case does x alter the ~ 
archive file. Normally the ‘last-modified’ date of each. 
extracted file is the date when it is extracted. However, if o 
is used, the ‘last-modified’ date is reset to the date recorded 
in the archive. 
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Verbose. Under the verbose option, bar gives a file-by-file — 
description of the making of a new archive file from the old 
archive and the constituent files. When used with t, it gives 
a long listing of all information about the files. When used 
with p, it precedes each file with a name. 


Create. Normally bar will create afile when it needs to. The 
create option suppresses the normal message that is pro- 
duced when afile is created. 


Local. Normally bar places its temporary files in the direc- 
tory /tmp. This option causes them to be placed in the local 
directory. 


/tmp/v* temporaries 


SEE ALSO 


lorder(1), arcv(1) 


BUGS 


If the same file is mentioned twice in an argument list, it may be put 


in the archive twice. 


The ‘last-modified’ date of a file will not be altered by the o option if 
the user is not the owner of the extracted file, or the super-user. 
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NAME 


bbanner — print large banner on printer 


SYNOPSIS 


/usr/plx/bbanner [ —-wn ] message ... 


DESCRIPTION 


NOTES 


Bbanner prints a large, high quality banner on the standard output. 
If the message is omitted, it prompts for and reads one line of its 
standard input. If —w is given, the output is scrunched down from a 
width of 132 ton, suitable for a narrow terminal. If n is omitted, it 
defaults to 80. 7 


The output should be printed on a hard-copy device, up to 132 | 
columns wide, with no breaks between the pages. The volume is 
enough that you want a printer or a fast hardcopy terminal, but if 
you are patient, a DECwriter or other 300 baud terminal will do. 


The Plexus version of this command is based on the one developed 
at the University of California at Berkeley. 


SEE ALSO 


BUGS 
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banner(1). jor 


Several ASCII characters are not defined, notably <, >, [, ], \, °, _, 
{, },| and ~. Also, the characters ", ', and & are funny looking (but in 
a useful way.) 


The —w option is implemented by skipping some rows and columns. 
The smaller it gets, the grainier the output. Sometimes it runs 
letters together. 
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bc — arbitrary-precision arithmetic language 


SYNOPSIS 


be [ -c ][-I] [file ... ] 


DESCRIPTION 
Bc is an interactive processor for a language that resembles C but 
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_ provides unlimited precision arithmetic. It takes input from any files 


given, then reads the standard input. The -! argument stands for 
the name of an arbitrary precision math library. The syntax for bc 
programs is as follows; L means letter a—-z, E means expression, S 


means statement. 


Comments ; 
are enclosed in /* and #/. 


Names 
simple variables: L 
array elements: L[E ] 
The words “ibase’, “obase’”, and “scale” 


Other operands 


arbitrarily long numbers with optional sign and decimal point. 


(E ) 

sqrt (E ) 

length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
LACE pate E) 


Operators 
+ —*/% ~*~ (% is remainder; * is power) 
++ — (prefix and postfix; apply to names) 
Ss=<=>=!-<> 
= =4 =- =# =/ =% =" 


Statements 
E 
}. OG tieso 
f(E)S 
while (E)S 
for(E;E;E)S 
null statement 
break 
quit 
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Function definitions \ 
define L(L,...,L){ 


auto L,..., Lb 
S:...5$ 
return (E ) 
j 
Functions in -! math library 
S(X) sine 


C(x) cosine 

e(x) exponential 

I(x) log 

a(x) arctangent 
j(n,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or new-lines 
may separate statements. Assignment to scale influences the 
number of digits to be retained on arithmetic operations in the 
manner of dc (7). Assignments to base or obase set the input and 


output number radix respectively. a 


The same letter may be used as an array, a function, and a simple ~~ 
variable simultaneously. All variables are global to the program. 
“Auto” variables are pushed down during function calls. When 
using arrays as function arguments or defining them as automatic 
variables empty square brackets must follow the array name. 


Bc is actually a preprocessor for dc (1), which it invokes automati- 
cally, unless the -c (compile only) option is present. In this case 
the dc input is sent to the standard output instead. 


EXAMPLE 
scale = 20 
define e(x){ 
auto b, ¢c, i, s 
= 
S = 
for(ii=1; 1==1;i++){ 
b = bi 
c= sib 
if(c == 0) return(s) 
S=srtc eos 
} | ee 
wet 


defines a function to compute an approximate value of the 
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( oN exponential function and 
ae for(i=1; i<=10; i+ +) e(i) 


prints approximate values of the exponential function of the first ten . 


integers. 
FILES 
/usr/lib/lib.b mathematical library 
/usribin/de desk calculator proper 
SEE ALSO 
dc(1). 


Sys5 UNIX Programmer Guide. 


BUGS 
No &&, | | yet. 
For statement must have all three E’s. 
Quit is interpreted when read, not when executed. 
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NAME 


bdiff — big diff 


SYNOPSIS 


bdiff file1 file2 [n] [-s] 


DESCRIPTION : 


FILES 


Bdiff is used in a manner analogous to diff (1) to find which lines 
must be changed in two files to bring them into agreement. Its pur- 
pose is to allow processing of files which are too large for diff. Bdiff 
ignores lines common to the beginning of both files, splits the 
remainder of each file into n -line segments, and invokes diff upon 
corresponding segments. The value of n is 3500 by default. If the 


optional third argument is given, and it is numeric, it is used as the © 


value for n . This is useful in those cases in which 3500-line seg- 
ments are too large for diff , causing it to fail. If file? (file2) is -, the 
standard input is read. The optional —s (silent) argument specifies 
that no diagnostics are to be printed by bdiff (note, however, that 
this does not suppress possible exclamations by diff . If both 
optional arguments are specified, they must appear in the order indi- 
cated above. 


The output of bdiff is exactly that of off , with line numbers adjusted 


to account for the segmenting of the files (that is, to make it look as. 


rad “e 


if the files had been processed whole). Note that because of the 


segmenting of the files, bdiff does not necessarily find a smallest 
sufficient set of file differences. 


SEE ALSO 


diff(1). 


DIAGNOSTICS 
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Use help (1) for explanations. 


May 22, 1985. 


BFS(1) 


UNIX Sys5 BFS(1) 


(me 
bfs — big file scanner 


SYNOPSIS 


bfs [ — ] name 


DESCRIPTION 
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The Bfs command is (almost) like ed (1) except that it is read-only 


and processes much larger files. Files can be up to 1024K bytes 


(the maximum possible size) and 32K lines, with up to 512 charac- 
ters, including new-line, per line (255 for 16-bit machines). 8fs is 
usually more efficient than ed for scanning a file, since the file is not 
copied to a buffer. It is most useful for identifying sections of a 
large file where csplit (1) can be used to divide it into more 
manageable pieces for editing. 


Normally, the size of the file being scanned ts printed, as is the size 
of any file written with the w command. The optional — suppresses 
printing of sizes. Input is prompted with * if P and a carriage return 
are typed as in ed . Prompting can be turned off again by inputting 
another P and carriage return. Note that messages are given in 
response to errors if prompting is turned on. 


All address expressions described under ed are supported. In addi- | 
tion, regular expressions may be surrounded with two symbols 
besides / and ? : > indicates downward search without wrap- 
around, and < _ indicates upward search without wrap-around. 
There is a slight difference in mark names: only the letters a through 
Zz may be used, and all 26 marks are remembered. 


Thee,g,v,k,p,q,w, =, ! and null commands operate as 
described under ed . Commands such as —, +++-, +++2=, 
-12, and +4p are accepted. Note that 1,10p and 1,10 will both 
print the first ten lines. The f command only prints the name of the 
file being scanned; there is no remembered file name. The w com- 
mand is independent of output diversion, truncation, or crunching 
(see the xo , xt and xc commands, below). The following addi- 
tional commands are available: 


xf file 
Further commands are taken from the named file . When 
an end-of-file is reached, an interrupt signal is received 
or an error occurs, reading resumes with the file contain- 
ing the xf. The xf commands may be nested to a depth 
of 10. 


xn List the marks currently in use (marks are set by the k 
command). 
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f ; 
xo [ file ( | 


Further output from the p and null commands is diverted 
to the named file , which, if necessary, is created mode 
666. If file is missing, output is diverted to the standard 
output. Note that each diversion causes truncation or 
creation of the file. 


: label 
This positions a /abe/f in a command file. The /abe/ is 
terminated by new-line, and blanks between the : and 
the start of the /abe/ are ignored. This command may 
also be used to insert comments into a command file, 
since labels need not be referenced. 


! 
/ 
we 


(.,.)xbiregular expression. label 

A jump (either upward or downward) is made to /abel if 

the command succeeds. It fails under any of the follow- 

ing conditions: 
1. Either address is not between 1 and $. 
2. The second address is less than the first. 
3. The regular expression does not match at 
least one line in the specified range, neIMeInG 7 are 


_ the first and last lines. » 
Sl See 


On success, . is set to the line matched and a jump is 
made to /abel. This command is the only one that does 
not issue an error message on bad addresses, so it may 
be used to test whether addresses are bad before other 
commands are executed. Note that the command 


xb/"/ label 


is an unconditional jump. 

The xb command is allowed only if it is read from some- 
place other than a terminal. If it is read from a pipe only 
a downward jump is possible. 


xt number 
Output from the p and null commands is truncated to at 
most number characters. The initial number is 255. 


xv[ digit] [spaces] [value] 
The variable name is the specified digit following the xv. 
The commands xv5100 or xv5 100 both assign the value 
100 to the variable 5 . The command Xv61,100p assigns o™ 
the value 1,100p to the variable 6 . To reference a vari- | 
able, put a % in front of the variable name. For exam- 
ple, using the above assignments for variables 5 and 6: 


y 
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eS 1 y(t) 8) 
aah 1,%5 
%6 
will all print the first 100 lines. 


g/%5ip 
would globally search for the characters 100 and print 


each line containing a match. To escape the special 
meaning of % , a \ must precede it. 


gi”. *\%[cds]/p 


could be used to match and list lines containing printf of 
characters, decimal integers, or strings. 

Another feature of the xv command is that the first line 
of output from a UNIX system command can be stored 
into a variable. The only requirement is that the first 
Character of va/ue be an !. For example: 


.W junk 
ee - xv5!cat junk 
( \ Irm junk 
al ) lecho "%5" 
xv6lexpr %6 + 1 
would put the current line into variable 5, print it, and 
increment the variable 6 by one. To escape the special 


meaning of ! as the first character of va/ue , precede it 
with a\. 


xv7/\ldate 
Stores the value !date into variable 7. 
xbz label _ 


- xbn /abel 
These two commands will test the last saved return 
code from the execution of a UNIX system command 
(command) or nonzero value, respectively, to the speci- 
fied label. The two examples below both search for the 
next five lines containing the string size. 


( . “v55 
i x : | 


/size/ 


Page 3 | | May 29, 1985 


BFS(1) | UNIX Sys5 _- BFS(1) 


xvolexpr %5 — 1 | | 
lif 0%5 != O exit 2 2. 
xbn | 

xv45 

a 

/SIZei 

xv4lexpr %4 — 1 
lif O%4 = 0 exit 2 
xbz | | 


xc [switch | 
If switch is 1, output from the p and null commands is 
crunched; if switch is Q it is not. Without an argument, | 
xc reverses switch. Initially switch is set for no crunch- 
ing. Crunched output has strings of tabs and blanks 
reduced to one blank and blank lines suppressed. 


SEE ALSO 

csplit(1), ed(1). 

regcmp(3X) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS 


? for errors in commands, if prompting is turned off. Self.--~ 
explanatory error messages when prompting is on. | 


Lea a oe 
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( ~YAME 
a, bls — list contents of directory 


SYNOPSIS 
/usr/pix/bls [ -abedfgilmqrstux1CFR ] name ... 


DESCRIPTION 

For each directory argument, bis lists the contents of the directory; 
for each file argument, b/s repeats its name and any other informa- 
tion requested. By default, the output is sorted alphabetically. 
When no argument is given, the current directory is listed. When 
several arguments are given, the arguments are first sorted 
appropriately, but file arguments appear before directories and their 
contents. 


There are three major listing formats. The format chosen depends 

on whether the output is going to a teletype, and may also be con- 

trolled by option flags. The default format for a teletype is to list the 

contents of directories in multi-column format, with the entries sorted 

down the columns. (Files that are not the contents of a directory 

being interpreted are always sorted across the page rather than 

down the page in columns. This is because the individual file 

. names may be arbitrarily long.) If the standard output is not a tele- 

( oe type, the default format is to list one entry per line. Finally, there is © 

a stream output format in which files are listed across the page, 
separated by ‘,’ characters. The —m flag enables this format. 


This command has many options: 


-| List in long format, giving mode, number of links, owner, 
size in bytes, and time of last modification for each file. 
(See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. 


—t Sort by time modified (latest first) instead of by name, as is 
normal. 

—a List all entries; usually ©.’ and ‘..’ are suppressed. 

—S . Give size in (1024-byte) blocks, including indirect blocks, for 
each entry. 

-d lf argument is a directory, list only its name, not its contents 


(mostly used with —| to get status on directory). 


-r Reverse the order of sort to get reverse alphabetic or oldest 
first as appropriate. 


—U Use time of last access instead of last modification for sort- 
ing (—t) or printing (-I). 
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—C 


-F 


—-R 
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ft a 
Use time of file creation for sorting or printing. ( Z 
Print i-number in first column of the report for each file — 
listed. 
Force each argument to be interpreted as a directory and 
list the name found in each slot. This option turns off -l, -t, 
—S, and -r, and turns on —a; the order is the order in which 
entries appear in the directory. 
Give group ID instead of owner ID in long listing. 
Force stream output format. 
Force one entry per line output format, e.g. to a teletype. 
Force multi-column output, e.g. to a file or a pipe. 
Force printing of non-graphic characters in file names as the 
character ‘?’; this normally happens only if the output device 
IS a teletype. 
Force printing of non-graphic characters to be in the \ddd 
rotation, in octal. 
Force columnar printing to be sorted across rather than . 
down the page: this is the default if the last character of the 
name the program is invoked with is an ‘x’. ed 


Cause directories to be marked with a trailing ‘ and execut- 
able files to be marked with a trailing ‘*’; this is the default if 
the last character of the name the program is invoked with 
isa f. 

Recursively list subdirectories encountered. 


The mode printed under the -I option contains 11 characters, which 
are interpreted as follows: the first character is 


d 


b 
Cc 
m 


if the entry is a directory; 

if the entry is a block-type special file; 

if the entry is a character-type special file; 

if the entry is a multiplexor-type character special file; 
if the entry is a plain file. 


The next 9 characters are interpreted as three sets of three bits 
each. The first set refers to owner permissions; the next to permis- 
sions to others in the same user-group; and the last to all others. 
Within each set the three characters indicate permission respec- 
tively to read, to write, or to execute the file as a program. Forays 


directory, ‘execute’ permission is interpreted to mean permission to\ 


ee ae 


search the directory for a specified file. The permissions are indi- 
cated as follows: 
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| ( ; if the file is readable; 
ail if the file is writable; 


if the file is executable; 
if the indicated permission is not granted. 


[xs 7 


The group-execute permission character is given as § if the file has 
set-group-ID mode; likewise the user-execute permission character 
is given as s if the file has set-user-ID mode. 


The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit 
of the mode is on. See chmod(1) for the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks is printed. 


FILES 
/etc/passwd to get user ID's for ‘bis -I. 
/etc/group to get group |D’s for ‘bls —g’. 
NOTES 
This command is based on the /s command from the University of 
California at Berkeley. 


_. BUGS 
: Newline and tab are considered printing characters in file names. 


The output device is assumed to be 80 columns wide. 


The option setting based on whether the output is a teletype is 
undesirable, because “bis —-s” ig very different from “bls —s| lpr”. 
On the other hand, not doing this setting would make old shell 
scripts that used /s almost certain not to work. 


Column widths choices are poor for terminals that can tab. 
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NAME 
bs — a compiler/interpreter for modest-sized programs : 


SYNOPSIS | 
bs [ file [ args ] ] 


DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C 
language thrown in. Bs is designed for programming tasks where 
program development time is as important as the resulting speed of 
execution. Formalities of data declaration and file/process. manipu- 
lation are minimized. Line-at-a-time debugging, the trace and 
dump statements, and useful run-time error messages all simplify 
program testing. Furthermore, incomplete programs can be 
debugged; inner functions can be tested eee outer | functions 
have been written and vice versa. ie Se 


N.. J 


If the command line file argument is provided, the file is used for 
input before the console is read. By default, statements read from 
the file argument are compiled for later execution. Likewise, state- 
ments entered from the console are normally executed immediately 
(see compile and execute below). Unless the final operation is 
assignment, the result of an immediate expression statement isy | 
printed. oe 


Bs programs are made up of input lines. If the last character on a 
line is a \, the line is continued. Bs accepts lines of the following 
form: 


statement 
label statement 


A label is a name (see below) followed by a colon. A label and a 
variable can have the same name. 


A bs statement is either an expression or a keyword followed by 
zero or more expressions. Some keywords (clear, compile , ! , 
execute , include , ibase , obase , and run ) are always executed 
as they are compiled. 


Statement Syntax: 


expression 
The expression is executed for its side effects (value, assign- 
ment, or function call). The details of expressions follow the 
description of statement types below. 


break —_ 
Break exits from the inner-most joriwhile ooo! ‘oe 


Paget May 22, 1985 


UNIX Sys5 BS(1) 


clear 
Clears the symbol table and compiled statements. Clear is exe- 
cuted immediately. 


compile [ expression | 
Succeeding statements are compiled (overrides the immediate 
execution default). The optional expression is evaluated and 
used as a file name for further input. A clear is associated with 
this latter case. Compile is executed immediately. 


continue 
Continue transfers to the loop-continuation of the current 
for/while loop. 


dump [ name | 
The name and current value of every non-local variable is 
printed. Optionally, only the named variable is reported. After 
an error or interrupt, the number of the last statement and (pos- 
sibly) the user-function trace are displayed. 


exit [ expression | 
Return to system level. The expression is returned as process 
Status. 


execute 
Change to immediate execution mode (an interrupt has a similar 
effect). This statement does not cause stored statements to 
execute (see run below). 


for name = expression expression statement 
for name = expression expression 


next 


for expression , expression , expression statement 
for expression , expression , expression 


next 

The for statement repetitively executes a statement (first form) 
or a group of statements (second form) under control of a named 
variable. The variable takes on the value of the first expression, 
then is incremented by one on each loop, not to exceed the 
value of the second expression. The third and fourth forms 
require three expressions separated by commas. The first of 
these is the initialization, the second is the test (true to continue), 
and the third is the loop-continuation action (normally an incre- 
ment). 
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fun f({a,...])[v,...] ' 


nuf 
Fun defines the function name, arguments, and local variables 
for a user-written function. Up to ten arguments and local vari- 
ables are allowed. Such names cannot be arrays, nor can they 
be I/O associated. Function definitions may not be nested. 


freturn | 
A way to signal the failure of a user-written function. See the 
interrogation operator (?) below. If interrogation is not present, 
freturn merely returns zero. When interrogation /s active, freturn 
transfers to that expression (possibly by-passing intermediate | 
function returns). 


goto name 
Control is passed to the internally stored statement with the 
matching label. 


ibase NV 
Ibase sets the input base (radix) to N . The only supported 
values for N are 8 , 10 (the default), and 16 . Hexadecimal 
values 10-15 are entered as a —f . A leading digit is required” 
(i.e., f0a must be entered as Of0a ). /base (and obase , below). 
are executed immediately. 


if expression statement 
if expression 


{ else 
- | 

fi 
The statement (first form) or group of statements (second form) 
is executed if the expression evaluates to non-zero. The strings 
0 and “” (null) evaluate as zero. In the second form, an optional 
else allows for a group of statements to be executed when the 
first group is not. The only statement permitted on the same line 
with an e/se is an if ; only other fi ’s can be on the same line 
with a fi . The elision of else and if into an elif is supported. 
Only a single fi is required to close an "if... elif..." "[ "else... 
""] sequence." 


include expression 
The expression must evaluate to a file name. The file must con- 
tain bs source statements. Such statements become part of the“ — 
program being compiled. /nclude statements may not be_/ 
nested. 
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obase N 

Obase sets the output base to N (see ibase above). 
onintr label 
onintr 


The onintr command provides program control of interrupts. In 
the first form, control will pass to the label given, just as if a goto 
had been executed at the time onintr was executed. The effect 
of the statement is cleared after each interrupt. In the second 
form, an interrupt will cause bs to terminate. 


return [expression] 
The expression is evaluated and the result is passed back as the 
value of a function call. If no expression is given, zero is 
returned. 


run 
The random number generator is reset. Control is passed to the 
first internal statement. If the run statement is contained in a 
file, it should be the last statement. 


stop | 
Execution of internal statements is stopped. 8s reverts to 
immediate mode. 


trace [ expression | 
The trace statement controls function tracing. If the expression 
is null (or evaluates to zero), tracing is turned off. Otherwise, a 
record of user-function calls/returns will be printed. Each return 
decrements the trace expression value. 


while expression statement 
while expression 


next 
While is similar to for except that only the conditional expression 
for loop-continuation is given. 


! shell command 
An immediate escape to the Shell. 


#... 
This statement is ignored. It is used to interject commentary in a 
program. 

Expression Syntax: 

name 


A name is used to specify a variable. Names are composed of a 
letter (upper or lower case) optionally followed by letters and 


May 22, 1985 Page 4 


BS(1) 


Page 5 


UNIX Sys5 BS(1) 


digits. Only the first six characters of a name are significant, 
Except for names declared in fun statements, all names are glo-- 


bal to the program. Names can take on numeric (double float) 
values, string values, or can be associated with input/output (see 
the built-in function open () below). 


name ( [expression [ , expression] ... ] ) 
Functions can be called by a name followed by the arguments in 
parentheses separated by commas. Except for built-in functions 
(listed below), the name must be defined with a fun statement. 
Arguments to functions are passed by value. 


name [ expression [, expression]... ] 


This syntax is used to reference either arrays or tables (see © 


built-in table functions below). For arrays, each expression is 
truncated to an integer and used as a specifier for the name. 
The resulting array reference is syntactically identical to a name; 
a[1,2] is the same as a[1][2] . The truncated expressions are 
restricted to values between O and 32767. 


number 
A number is used to represent a constant value. A number is 


fs 


written in Fortran style, and contains digits, an optional decimal~ ~~ 


point, and possibly a scale factor consisting of an e followed by é. 
possibly signed exponent. 


string 
Character strings are delimited by “ characters. The \ escape 
character allows the double quote (\"), new-line (\n), carriage 
return (\r), backspace (\b), and tab (\t) characters to appear in a 
string. Otherwise, \ stands for itself. 


( expression ) 
Parentheses are used to alter the normal order of evaluation. 


( expression, expression [, expression ... ] ) [ expression ] 
The bracketed expression is used as a subscript to select a 
comma-separated expression from the parenthesized list. List 
elements are numbered from the left, starting at zero. The 
expression: 


( False, True )[ a == b] 
has the value True if the comparison is true. 


? expression 
The interrogation operator tests for the success of the expres-, 
sion rather than its value. At the moment, it is useful for testing 
end-of-file (see examples in the Programming Tips section™ 
below), the result of the eva/ built-in function, and for checking 
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the return from user-written functions (see freturn ). An interro- 
gation ‘trap’ (end-of-file, etc.) causes an immediate transfer to 
the most recent interrogation, possibly skipping assignment 
statements or intervening function levels. 


— expression 
The result is the negation of the expression. 


++ name 
Increments the value of the variable (or array reference). The 
result is the new value. 


— name 
Decrements the value of the variable. The result is the new 
value. 


! expression 
The logical negation of the expression. Watch out for the shell 
escape command. 


expression operator expression 
Common functions of two arguments are abbreviated by the two 
arguments separated by an operator denoting the function. 
Except for the assignment, concatenation, and relational opera- 
tors, both operands are converted to numeric form before the - 
function is applied. 


Binary Operators (in increasing precedence): 


= is the assignment operator. The left operand must be a name 
or an array element. The result is the right operand. Assign- 
ment binds right to left, all other operators bind left to right. 


_ (underscore) is the concatenation operator. 


& | 
& (logical and) has result zero if either of its arguments are zero. 
It has result one if both of its arguments are non-zero; | (logical 
or) has result zero if both of its arguments are zero. It has result 
one if either of its arguments is non-zero. Both operators treat a 
null string as a zero. 


< <= > >= == l= 
The relational operators (< less than, <= less than or equal, > 
greater than, >= greater than or equal, == equal to, != not 
equal to) return one if their arguments are in the specified rela- 
tion. They return zero otherwise. Relational operators at the 
same level extend as follows: a>b>c is the same as a>b & 
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b>c. A string comparison is made if both operands are strings. ( y 
—_ : 
Add and subtract. 


* | % 
Multiply, divide, and remainder.. 


Exponentiation. 
Built-in Functions: 


Dealing with arguments 


arq(i) | 
is the value of the / -th actual parameter on the current level of 
function call. At level zero, arg returns the / -th command-line 
argument (arg (0) returns bs ). 


narg() 
returns the number of arguments passed. At level zero, the 


command argument count is returned. 


Mathematical 
xo OS 

abs(x) a 

is the absolute value of x . atl 
atan(x) 

is the arctangent of x . Its value is between —7/2 and v2. 
ceil(x) 

returns the smallest integer not less than x . 
cos(x) 

is the cosine of x (radians). 
exp(x) 

is the exponential function of x . 
floor(x) 

returns the largest integer not greater than x . 
log(x) 

is the natural logarithm of x. 
rand() 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 7% 


is the square root of x. 
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String operations 


size(s) 
the size (length in bytes) of s is returned. 


format(f, a) 
returns the formatted value of a . F is assumed to be a format 
specification in the style of printf (3S). oo the %...f, %...e, 
and %...S types are safe. 


index(x, y) 
returns the number of the first position in x that any of the char- 
acters from y matches. No match yields zero. 


trans(s, f, t) 
Translates characters of the source s from matching characters 
in f to a character in the same position in t. Source characters 
that do not appear in f are copied to the result. If the string f is 
longer than t , source characters that match in the excess por- 
tion of f do not appear in the result. 


substr(s, start, width) 
returns the sub-string of s defined by the start ing position and 
width . 


match(string, pattern) 

mstring(n) 
The pattern is similar to the regular expression syntax of the ed 
(1) command. The characters ., [, ], * (inside brackets), * and $ 
are special. The mstring function returns the n-th (1 <=n <= 
10) substring of the subject that occurred between pairs of the 
pattern symbols \( and \) for the most recent call to match . To 
succeed, patterns must match the beginning of the string (as if 
all patterns began with *). The function returns the number of 
characters matched. For example: 


match("a123ab123", ".+\([a—z]\)") == 6 
mstring(1) == "b" 


File handling 


open(name, file, function) 

close(name) 
The name argument must be a bs variable name (passed as a 
string). For the open , the file argument may be 1) a 0 (zero), 
1, or 2 representing standard input, output, or error output, 
respectively; 2) a string representing a file name; or 3) a 
string beginning with an ! representing a command to be exe- 
cuted (via sh -c ). The function argument must be either r 
(read), w (write), W (write without new-line), or a (append). After 
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a close , the name reverts to being an ordinary variable. The ini. » 


tial associations are: Ss 


open("get”, 0, "r’) 
open("put", 1, “w") 
open("puterr", 2, "w") 


Examples are given in the following section. 


access(s, m) 
executes access (2). 


ftype(s) 
returns a single character file type indication: f for regular file, p 
for FIFO (i.e., named pipe), d for directory, b for block special, or 
c for character special. 


Tables 


table(name, size) 
A table in bs is an associatively accessed, single-dimension 
array. “Subscripts” (called keys) are strings (numbers are con- 
verted). The name argument must be a bs variable name 
(passed as a string). The size argument sets the minimum 
number of elements to be allocated. Bs prints an error message” 
and stops on table overflow. ew 


Sa: x 


item(name, i) 


key() 

The item function accesses table elements sequentially (in nor- 

~ mal use, there is no orderly progression of key values). Where 
the item function accesses values, the key function accesses 
the “subscript” of the previous item call. The name argument 
should not be quoted. Since exact table sizes are not defined, 
the interrogation operator should be used to detect end-of-table; 
for example: 


table("t", 100) 


# |f word contains "party", the following expression adds 
one 

# to the count of that word: 

+ +t[word] 


# To print out the the key/value pairs: 
for i = 0, ?(s = item(t, i)), ++i if key() put =—~ 


key()_":"_s x 
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( \ iskey(name, word ) 
ae The iskey function tests whether the key word exists in the table 
name and returns one for true, zero for false. 


Odds and ends 


eval(s) 
The string argument is evaluated as a bs expression. The func- 
tion is handy for converting numeric strings to numeric internal 
form. Eval can also be used as a crude form of indirection, as 
in: 
name = “xyz” 
eval("+ +"_ name) 


which increments the variable xyz . In addition, eva/ preceded by 
the interrogation operator permits the user to control bs error 
conditions. For example: 


Peval("“open(\"X\", \"XXX\", \V"rh"P)") 


returns the value zero if there is no file named “XXX” (instead of 
halting the user's program). The following executes a goto to 
the label L (if it exists): 


} label ="L 


if '\(?eval(“goto "_ label)) puterr = "no label" 


plot(request, args) 
The plot function produces output on devices recognized by 
tplot (1G). The requests are as follows: 


Call Function 


plot(0, term) causes further p/of output to 
be piped into tp/ot (7G) with 
an argument of —Tterm. 


plot(4) “erases” the plotter. 

plot(2, string) labels the current point with 
String . 

plot(S, x1, y1, x2, y2) draws the line between 
(x7,y7) and (x2,y2). 

plot(4, x, y, r) draws a circle with center 


(x,y) and radius r. 


= plot(5, x1, y1, x2, y2, x3, y3)_ draws an arc (counterclock- 

( *, wise) with center (x7,y7) 

hoy and endpoints (x2,y2) and 
(x3,y3). 
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plot(6) 
plot(7, x, y) 


plot(8, x, y) 


plot(9, x, y) 
plot(10, string) 
~plot(11, x1, y1, x2, y2) 


plot(12, x1, y1, x2, y2) 


is not implemented. 


makes the current point 
(x,y). 


draws a line from the current 
point to (x,y). 


draws a point at (x,y). 
sets the line mode to string . 


makes (x7,y7) the lower left 
corner of the plotting area 


ne, 


and (x2,y2) the upper right - 


corner of the plotting area. 


causes subsequent x (y) 
coordinates to be multiplied 
by x7 (y7) and then added 
to x2 (y2) before they are 
plotted. The initial scaling is 
plot(12, 1.0, 1.0, 0.0, 0.0) . 


Some requests do not apply to all plotters. All requests except —~ 


zero and twelve are implemented by piping characters to tplo. 


(1G). See plot (4) for more details. 
last() 


in immediate mode, /asf returns the most recently computed 


value. 


PROGRAMMING TIPS 
Using bs as a calculator: 


$ bs 


# Distance (inches) light travels in a nanosecond. 


186000 * 5280 + 12; 1e9 
11.78496 


# Compound interest (6% for 5 years on $1,000). 


int = .06/4 

bal = 1000 

fori = 15*4 bal = bal + bal«int 
bal — 1000 

346.855007 

exit 


The outline of a typical bs program: 
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( a # initialize things: 
ke varl = 1 


tenet 


# compute: 
while ?(str = read) 


next 
# Clean up: 
close("read”) 


# last statement executed (exit or stop): 
exit 

# last input line: 

run 


Input/Output examples: 


# Copy “oldfile" to "newfile”. 
open("read", “oldfile”, "r') 
open("write", “newfile", "w") 


( while ?(write = read) 


# close "read" and "write": 
close("read") 
close("write") 


# Pipe between commands. 
open(“Is”, “Ils =", “r’) 

open("pr", “lpr —2 —h ‘List’”, "w") 
while ?(pr = Is) ... 


# be sure to close (wait for) these: 
close("Is") 
close(‘pr’) 


SEE ALSO 

ed(1), sh(1), tplot(1G). | 

access(2), printf(3S), stdio(3S), plot(4) in the “Sys5 UNIX Program- 

mer Reference Manual" . 

See Section 3 of the Sys5 UNIX Programmer Reference Manual for 
7 a further description of the mathematical functions (pow on exp 
( * (3M) is used for exponentiation); bs uses the Standard Input/Output 
package. 
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NAME an 
cal — print calendar ed 
SYNOPSIS 
cal [ [ month ] year | 
DESCRIPTION | 
Cal prints a calendar for the specified year. If a month is also 
specified, a calendar just for that month is printed. If neither is 
specified, a calendar for the present month is printed. Year can be 
between 1 and 9999. The month is a number between 1 and 12. 
The calendar produced is that for England and her colonies. 
Try September 1752. 
BUGS 
The year is always considered to start in January even though this 
is historically naive. 
Beware that “cal 83” refers to the early Christian era, not the 20th 
century. 
/ a 5 
i 
ee 
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( NAME 
226 calendar — reminder service 


SYNOPSIS 
calendar [ — | 


DESCRIPTION 
Calendar consults the file calendar in the current directory and 
prints out lines that contain today’s or tomorrow's date anywhere in 
the line. Most reasonable month-day dates such as “Aug. 24,” 
“august 24,” “8/24,” etc., are recognized, but not “24 August” or 
“24/8”. On weekends “tomorrow” extends through Monday. 


When an argument is present, calendar does its job for every user 
who has a file calendar in the login directory and sends them any 
positive results by mail (1). Normally this is done daily by facilities in 
the UNIX operating system. 


FILES 
/usr/lib/calprog to figure out today’s and tomorrow's dates 


/etc/passwd 
/tmp/cal* 


( 


~~ SEE ALSO 
mail(1). - 

BUGS 
Your calendar must be public information for you to get reminder 
service. 
Calendar’s extended idea of “tomorrow” does not account for holi- 
days. 
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NAME - 
cat — concatenate and print files eA 


SYNOPSIS 
cat [ -u ] [ -s ] file ... 


DESCRIPTION 
Cat reads each file in sequence afd writes it on the standard out- 
put. Thus: 


cat file 
prints the file, and: 
cat file1 file2 >file3 
concatenates the first two files and places the result on the third. 


If no input file is given, or if the argument —- is encountered, cat 
reads from the standard input file. Output is buffered in 512-byte 
blocks unless the —u option is specified. The —s option makes cat 
silent about non-existent files. No input file may be the same as the 
output file unless it is a special file. 


NOTES 
Plexus provides a standalone version of cat in addition to a one , a 
that runs under Sys5. oy 
SEE ALSO 
cp(1), pr(1). 
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—~NAME 
( 4 cb — C program beautifier 

SYNOPSIS 
cb [-s ][-j ][-I leng ] [ file ... ] 

DESCRIPTION 
Cb reads C programs either from its arguments or from the stan- 
dard input and writes them on the standard output with spacing and 
indentation that displays the structure of the code. Under default 
options, cb preserves all user new-lines. Under the —s flag cb 
Ccanonicalizes the code to the style of Kernighan and Ritchie in The 
C Programming Language . The -j flag causes split lines to be put 
back together. The —I flag causes cb to split lines that are longer 
than leng . | 

SEE ALSO 
cc(1). 
The C Programming Language by B. W. Kernighan and D. M. 
Ritchie. | 

BUGS 
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Punctuation that is hidden in preprocessor statements will Cause 
indentation errors. 
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NAME yes 
cc, pcc — C compiler Ky 
SYNOPSIS 
cc [ option ] ... file ... 
pcc [ option |] ... file ... 
DESCRIPTION 
Cc is the UNIX system C compiler. It accepts several types of argu- 
ments. 


Arguments whose names end with .c are taken to be C source pro- 
grams. They are compiled, and each object program is left on the 
file whose name is that of the source with .o substituted for .c. The 
.O file is normally deleted, however, if a single C program is com- 
piled and loaded ail at one go. 


In the same way, arguments whose names end with .s are taken to 
be assembly source programs and are assembled, producing a .o 
file. 


The following options are interpreted by cc and pcc . See /d (1) for 
link editor options and cpp (7) for more preprocessor options. 


—c Suppress the link edit phase of the compilation and force va 
an object file to be produced even if only one program is ‘ 3 
compiled. — 

—p Arrange for the compiler to produce code that counts the 


number of times each routine is called; also, if link editing 
takes place, replace the standard startoff routine by one. 
that automatically calls monitor (3C) at the start and 
arranges to write out a mon.out file at normal termination 

of execution of the object program. An execution profile 
can then be generated by use of prof (7). 


—f Link the object program with the floating-point interpreter 
for systems without hardware floating-point. 

—g Cause the compiler to generate additional information 
needed for the use of cab. 

—O Invoke an object-code optimizer. 

-S Compile the named C programs and leave the assembler- 
language output on corresponding files suffixed -s. 

—E Run only cpp (7) on the named C programs and send the 
result to the standard output. oo 

—P Run only cpp (1) on the named C programs and leave the Y 


result on corresponding files suffixed .i. 
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—Bstring 
Construct pathnames for substitute preprocessor, compiler, 
assembler and link editor passes by concatenating string 
with the suffixes cpp , c0 (or ccom or comp , see under 
FILES below), c1 , c2 (or optim ), as and Id. If string is 
empty it is taken to be /lib/o . 


—t [ p012al | 
Find only the designated preprocessor, compiler, assem- 
bler and link editor passes in the files whose names are 
constructed by a —B option. In the absence of a —B option, 
the string is taken to be /lib/n . The value -t "" is 
equivalent to —tp012 . 


—Wc,arg1/,arg2...] 
Hand off the argument[s] argi to pass c where c is one of 
[p012al] indicating preprocessor, compiler first pass, com- 
piler second pass, optimizer, assembler, or link editor, 
respectively. 


Other arguments are taken to be either link editor option arguments, 
C preprocessor option arguments, or C-compatible object programs, 
typically produced by an earlier cc or pcc run, or perhaps libraries 
of C-compatible routines. These programs, together with the results . 
of any compilations specified, are linked (in the order given) to pro- 
duce an executable program with the name a.out . 


file.c input file 

file.o object file 

a.out linked output 

/tmp/ctm* temporary 
/usr/tmp/ctm* temporary 

/lib/cpp C preprocessor cpp (1) 


/usr/lib/comp 
/usr/lib/Oc* 


compiler, pcc 
backup compiler, Occ 


/bin/as assembler, as (7) 

/bin/\d link editor, /d (1) 

/lib/crt0.o runtime startoff 

/tib/mert0.o profiling startoff 

/lib/fcrtO.o floating-point interpretation startoff 

/lib/fmcrtO.o floating-point interpretation and profiling 
startoff 

/lib/lilbc.a standard C library, see section (3) in the 
Sys5 UNIX (3) Programmer’s Reference 
Manual 

/lib/ibp/lib+.a profiled versions of libraries 


Mr ntmlanse "7 4ANOL 
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SEE ALSO | —_ 
adb(1), cpp(1), as(1), Id(1), prof(1). ew 
exit(2), monitor(3C) in the Sys5 UNIX Programmer Reference 
Manual. 


The C Programming Language by B. W. Kernighan. 
Programming in C-A Tutorial by B. W. Kernighan. 
C Reference Manual by D. M. Ritchie. 


NOTES 
By default, the return value from a C program is completely random. 
The only two guaranteed ways to return a specific value are to expli- 
citly call exit (2) or to leave the function main ( ) with a “return 
expression ;’’ construct. 


DIAGNOSTICS 
The diagnostics produced by C itself are intended to be self- 
explanatory. Occasional messages may be produced by the 
assembler or the link editor. m _, which means a multiply-defined 
external symbol (function or data). 


Hey a 


( 
~_ 
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(wane 
ae? cd — change working directory 


SYNOPSIS 
| cd [ directory | 


DESCRIPTION 

If directory is not specified, the value of shell parameter $HOME is 
used as the new working directory. If directory specifies a complete 
path starting with / , . , .. , directory becomes the new working 
directory. If neither case applies, cd tries to find the designated 
directory relative to one of the paths specified by the $CDPATH shell 
variable. $CDPATH has the same syntax as, and similar semantics 
to, the $PATH shell variable. Cd must have execute (search) per- 
mission in directory . 


Because a new process is created to execute each command, cd 
would be ineffective if it were written as a normal command; there- 
fore, it is recognized and is internal to the shell. 


SEE ALSO 


pwd(1), sh(1). 
~ chdir(2) in the Sys5 UNIX Programmer Reference Manual. 
(_ 
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NAME i 


cdc — change the delta commentary of an SCCS delta QL 
SYNOPSIS 

cde -rSID [—m[mrlist]] [-y[comment]] files 
DESCRIPTION 7 


Cdc changes the delta commentary , for the S/D specified by the -r 
keyletter, of each named SCCS file. 


Delta commentary is defined to be the Modification Request (MR) 
and comment information normally specified via the delta (1) com- 
mand (—m and —y keyletters). 


lf a directory is named, cdc behaves as though each file in the — 
directory were specified as a named file, except that non-SCCS files 
(last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of — is given, the 
standard input is read (see WARNINGS); each line of the standard 
input is taken to be the name of an SCCS file to be processed. 


Arguments to cdc , which may appear in any order, consist of 
keyletter arguments and file names. 


All the described key/etter arguments apply independently to eacty ~ 
named file: i 


-rS/D Used to specify the S CCS /D entification 
(S/D) string of a delta for which the delta com- 
mentary is to be changed. 


—m[mriist] If the SCCS file has the v flag set (see admin 
(7)) then a list of MR numbers to be added 
and/or deleted in the delta commentary of the 
SID specified by the -r keyletter may be sup- 
plied. A null MR list has no effect. 


MR entries are added to the list of MRs in the 
same manner as that of delta (1). In order to 
delete an MR, precede the MR number with 
the character ! (see EXAMPLES). If the MR to 
be deleted is currently in the list of MRs, it is 
removed and changed into a “comment” line. 
A list of all deleted MRs is placed in the com- 
ment section of the delta commentary and 
preceded by a comment line stating that they 


were deleted. . a 


lf -m is not used and the standard input is be a 


terminal, the prompt MRs? is issued on the 


Pagel | May 27, 1985 


CDC(1)_ 


May 27, 1985 


-y[comment] 


UNIX Sys5 CDC(1) 


standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRS? prompt 
always precedes the comments? prompt 
(see —y keyletter). 


MRs in a list are separated by blanks and/or 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 


Note that if the v flag has a value (see admin 
(1)), it is taken to be the name of a program 
(or shell procedure) which validates the 
correctness of the MR numbers. If a non- 
zero exit status is returned from the MR 
number validation program, cdc terminates 
and the delta) commentary = remains 
unchanged. 


Arbitrary text used to replace the comment(s) 
already existing for the delta specified by the 
-r keyletter. The previous comments are 
kept and preceded by a comment line stating 
that they were changed. A null comment has — 
no effect. 


If -y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 


The exact permissions necessary to modify the SCCS file are 
documented in the Source Code Control System User Guide . 
Simply stated, they are either (1) if you made the delta, you 
can change its delta commentary; or (2) if you own the file and 
directory you can modify the delta commentary. 
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EXAMPLES | . . , 
; cde -11.6 —m'bI78-12345 'bI77-54321 bI79-00001" —ytrouble ~~ 
s.file | 


adds bI78-12345 and bI79-00001 to the MR list, removes bI77-54321 
from the MR list, and adds the comment trouble to delta 1.6 of 
S.file. | | 


cdc -11.6 s.file | | 
MRs? !bI77-54321 bI78-12345 bI79-00001 
comments? trouble 


does the same thing. 


WARNINGS 
If SCCS file names are supplied to the cdc command via the stan- 
_ dard input (— on the command line), then the -—m and —y keyletters 
must also be used. 7 


FILES 
x-file | (see delta (7)) 
z-file (see delta (1)) 
SEE ALSO | Jere 
| ~ admin(1), delta(1), get(1), help(1), prs(1). fo 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. ee 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS, a 
Use help (71) for explanations. 


—_ 
Me cae 
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| ( NAME 


Page 1 


cflow— generate C flow graph 


SYNOPSIS 


cflow [-r] [-ix] [-i_ ] [-dnum] files 


DESCRIPTION 


Cflow analyzes a collection of C, YACC, LEX, assembler, and object 
files and attempts to build a graph charting the external references. 
Files suffixed in .y , .1, .c , and .i are YACC'd, LEX’d, and C- 
preprocessed (bypassed for .i files) as appropriate and then run 
through the first pass of lint (1). (The -1 , -D , and —U options of the 
C-preprocessor are also understood.) Files suffixed with .s are 
assembled and information is extracted (as in .o files) from the sym- 
bol table. The output of all this non-trivial processing is collected 
and turned into a graph of external references which is displayed 
upon the standard output. 


Each line of output begins with a reference (i.e., line) number, fol- 
lowed by a suitable number of tabs indicating the level. Then the 
name of the global (normally only a function not defined as an exter- 
nal or beginning with an underscore; see below for the —i inclusion 
option) a colon and its definition. For information extracted from C 
source, the definition consists of an abstract type declaration (e.g., © 
char * ), and, delimited by angle brackets, the name of the source 
file and the line number where the definition was found. Definitions 
extracted from object files indicate the file name and location 
counter under which the symbol appeared (e.g., fext ). Leading 
underscores in C-style external names are deleted. 


Once a definition of a name has been printed, subsequent refer- 
ences to that name contain only the reference number of the line 
where the definition may be found. For undefined references, only 
<> is printed. As an example, given the following in file.c : 


int i; 
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oo 
-_ 


Somer 2 


— the command 
cflow —ix file.c 
produces the output 


1 main: int(), <file.c 4> 

2 f: int), <file.c 11> 

3 h: <> 

4 i: int, <file.c 1> 
fs) Gg. <> 


When the nesting level becomes too deep, the —e option of pr (7) 
can be used to compress the tab expansion to something less than 
every eight spaces. 


The following options are interpreted by cflow : 


-r -—- Reverse the “caller:callee” relationship producing an 
inverted listing showing the callers of each function. The. ~ 
listing is also sorted in lexicographical order by callee. | 


—ix Include external and static data symbols. The default is to 
include only functions in the flowgraph. 


—i_ Include names that begin with an underscore. The default is 
to exclude these functions (and data if -/x is used). 
—d num 
The num decimal integer indicates the depth at which the 
flowgraph is cut off. By default this is a very large number. 
Attempts to set the cutoff depth to a nonpositive integer will 
be met with contempt. 
DIAGNOSTICS 
Complains about bad options. Complains about multiple definitions 
and only believes the first. Other messages may come from the 
various programs used (e.g., the C-preprocessor). 
SEE ALSO 
as(1), cc(1), cpp(1), lex(1), lint(1), nm(1), pr(1), yacc(1). 
BUGS | 
Files produced by /ex (1) and yacc (7) cause the reordering of line _ 


number declarations which can confuse cflow . To get prope’ 
results, feed cflow the yacc or /ex input. . 
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chmod — change mode 


SYNOPSIS 


chmod mode files 


DESCRIPTION 


Page 1 


The permissions of the named files are changed according to mode 
, which may be absolute or symbolic. An absolute mode is an octal 
number constructed from the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod (2) 

0400 read by owner 

0200 write by owner 

0100 execute (Search in directory) by owner 
0070 read, write, execute (search) by group 
0007 read, write, execute (search) by others 


A symbolic mode has the form: 
[ who | op permission [{ | 


The who part is a combination of the letters u (for user's permis- 
sions), g (group) and o (other). The letter a stands for ugo , the | 
default if who is omitted. 


Op can be + to add permission to the file’s mode, - to take away 
permission , or = to assign permission absolutely (all other bits will 
be reset). 


Permission is any combination of the letters r (read), w (write), x 
(execute), s (Set owner or group ID) and t (save text, or sticky); u, 
g , Or O indicate that permission is to be taken from the current 
mode. Omitting permission is only useful with = to take away all 
permissions. 


Multiple symbolic modes separated by commas may be given. 
Operations are performed in the order specified. The letter s is only 
useful with u or g and t only works with u. 


Only the owner of a file (or the super-user) may change its mode. 
Only the super-user may set the sticky bit. In order to set the group 
ID, the group of the file must correspond to your current group ID. 
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—_ 
EXAMPLES Lg 
The first example denies write permission to others, the second ~~ 
makes a file executable: 
chmod o—w file 
chmod +x file 
SEE ALSO 
Is(1). 
chmod(2) in the Sys5 UNIX Programmer Reference Manual. 
fo™. 
( ' 
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( > NAME 
ow chown, chgrp — change owner or group 
SYNOPSIS 


q 
\ 
l 
( 
al 


FILES 
/etc/passwd 
/etc/group 

-~.. SEE ALSO 
} chmod(1). 

chown(2), group(4), passwd(4) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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chown owner file ... 


chgrp group file ... 


DESCRIPTION 


Chown changes the owner of the files to owner . The owner may be 
either a decimal user ID or a login name found in the password file. 


Chgrp changes the group ID of the files to group . The group may 
be either a decimal group ID or a group name found in the group 
file. 


If either command is invoked by other than the super-user, the set- 
user-ID and set-group-ID bits of the file mode, 04000 and 02000 
respectively, will be cleared. 


CLEAR(1) (Plexus) CLEAR(1) 


| —_— 
NAME | & 
clear — clear terminal screen ee 
SYNOPSIS 
/usr’/pl\x;clear 
DESCRIPTION 


Clear clears your screen if this is possible. It looks in the environ- 
ment for the terminal type and then in ‘etc‘termcap to figure out 
how to clear the screen. 


FILES 
/etc‘termcap — terminal capability data base 


NOTES 
This command is based on a similar one developed at the University 
of California at Berkeley. 


foo 
f : 
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°°. NAME 
( a cmp — compare two files 


SYNOPSIS 
cmp [ -I] [ -s ] [ -b buf_blocks ] file1 file2 


DESCRIPTION 
The two files are compared. (If file? is — , the standard input is 
used.) Under default options, cmp makes no comment if the files 
are the same; if they differ, it announces the byte and line number 
at which the difference occurred. If one file is an initial subse- 
quence of the other, that fact is noted. 


Options: 

| Print the byte number (decimal) and the differing 
bytes (octal) for each difference. 

—-S Print nothing for differing files; return codes only. 


—b buf_blocks Use input buffer of buf_blocks (decimal) blocks 
rather than the usual one block. This is useful for 
comparing a blocked tape. 


SEE ALSO 
( a comm(1), diff(1). 
\_” DIAGNOSTICS 


Exit code 0 is returned for identical files, 1 for different files, and 2 
for an inaccessible or missing argument. 
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NAME 
col — filter reverse line-feeds 
SYNOPSIS 
col [ —bfpx | 
DESCRIPTION 


Col reads from the standard input ani writes onto the standard out- 
put. It performs the line overlays implied by reverse line feeds 
(ASCIl code ESC-7), and by forward and reverse half-line feeds 
(ESC-9 and ESC-8). Co/ is particularly useful for filtering mul- 
ticolumn output made with the .rt command of nroff and output 
resulting from use of the fb/ (7) preprocessor. 


If the —b option is given, co/ assumes that the output device in use | 


is not capable of backspacing. In this case, if two or more charac- 
ters are to appear in the same place, only the last one read will be 
output. 


Although co/ accepts half- line motions | in its input, it sonmally does 
not emit them on output. Instead, text that would appear between 
lines is moved to the next lower full-line boundary. This treatment 
can be suppressed by the -f (fine) option; in this case, the output 
from col may contain forward half-line feeds (ESC-9), but will still 
never contain either kind of reverse line motion. &e 


Unless the —x option is given, co/ will convert white space to tabs on 
output wherever possible to shorten printing time. 


The ASCH control characters SO (\016) and SI (\017) are assumed 
by co/ to start and end text in an alternate character set. The char- 
acter set to which each input character belongs is remembered, and 
on output SI and SO characters are generated as appropriate to 
ensure that each character is printed in the correct character set. 


On input, the only control characters accepted are space, back- 
space, tab, return, new-line, SI, SO, VT (\013), and ESC followed by 
7,8,0or 9. The VT character is an alternate form of full reverse 
line-feed, included for compatibility with some earlier programs of 
this type. All other non-printing characters are ignored. 


Normally, co/ will ignore any unknown to it escape sequences found 
in its input; the —p option may be used to cause co/ to output these 
sequences as regular characters, subject to overprinting from 
reverse line motions. The use of this option is highly discouraged 
unless the user is fully aware of the textual position of the escape 
sequences. 


SEE ALSO 
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nroff(1), tbl(1). 
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( tOTES 

aa The input format accepted by co! matches the output produced by 
nroff with either the —T37 or -—Tlp options. Use -—T37 (and the -f 
option of col ) if the ultimate disposition of the output of co/ will be a 
device that can interpret half-line motions, and —-Tlp otherwise. 

BUGS 

Cannot back up more than 128 lines. 
Allows at most 800 characters, including backspaces, on a line. 
Local vertical motions that would result in backing up over the first 


line of the document are ignored. As a result, the first line must not 
have any superscripts. 
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a aa: 
NAME | - eG 
-comb ~. combine SCCS deltas . | Se 
SYNOPSIS —_ : _—_ 
| comb [-o] rs [-psid ere files 
DESCRIPTION. | 


Comb generates a shell procedure (see sh (7)) which, when run, 
will reconstruct the given SCCS files. The reconstructed files will, 
hopefully, be smaller than the original files. The arguments may be 
specified in any order, but all keyletter arguments apply to all named 
SCCS files. If a directory is named, comb behaves as though each 
file in the directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin with s.) | 
and unreadable files are silently ignored. If a name of — is given, 
the standard input is read; each line of the input is taken to be the 
name of an SCCS file to be processed; non-SCCS files and unread- 
able files are silently ignored. The generated shell procedure is writ- 
ten on the standard output. 


The keyletter arguments are as follows. Each is explained as 
though only one named file is to be processed, but the effects of | 
any keyletter argument apply independently to each named file. f 


-psiD TheS CCS /D entification string (SID) of the oldest delta to~ os ie 
be preserved. All older deltas are discarded in the recon- 
structed file. 


. N 
\ 
\ 


—clist A list (see get (7) for the syntax of a /ist) of deltas to be 
preserved. All other deltas are discarded. 


—O For each get -e generated, this argument causes the 
reconstructed file to be accessed at the release of the delta 
to be created, otherwise the reconstructed file would be 
accessed at the most recent ancestor. Use of the -—o 
keyletter may decrease the size of the reconstructed SCCS 
file. It may also alter the shape of the delta tree of the ori- 
ginal file. | 


-S This argument causes comb to generate a shell procedure 
which, when run, will produce a report giving, for each file: 
the file name, size (in blocks) after combining, original size 
(also in blocks), and percentage change computed by: | 

100 * (original — combined) / original 

It is recommended that before any SCCS files are actually 
combined, one should use this option to determine exactly’ > 
how much space is saved by the combining process. ee 
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If no keyletter arguments are specified, comb will preserve 
only leaf deltas and the minimal number of ancestors 
needed to preserve the tree. 


FILES 
s.COMB The name of the reconstructed SCCS file. 
comb????? Temporary. 

SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1), sh(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 

DIAGNOSTICS | 
Use help (1) for explanations. 

BUGS 


Comb may rearrange the shape of the tree of deltas. It may not 
save any space; in fact, it is possible for the reconstructed file to 
actually be larger than the original. 
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NAME _ [ tee yy i -_ 
comm -— select or reject lines common to two sorted files aly 
SYNOPSIS | | | | 
comm [ — [ 123 ] ] file1 file2 
DESCRIPTION 
Comm reads file? and file2 , whieh should be ordered in ASCII col- 
lating sequence (see sort (1)), and produces a three-column output: 
lines only in file7 ; lines only in file2 ; and lines in both files. The file 
name — means the standard input. 
Flags 1, 2, of 3 suppress printing of the corresponding column. 
Thus comm -12 prints only the lines common to the two files; 
comm —-23 prints only lines in the first file but not in le second; 
comm —123 is a no-op. . 
SEE ALSO 
cmp(1), diff(1), sort(1), uniq(1). 
‘ a “s 
| Ne Bs 
_ 
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“NAME 
_ cp, In, mv — copy, link or move files 


SYNOPSIS 
cp filet [ file2 ...] target 
In [ -f ] file1 [ file2 ...] target 
mv [ -f ] file1 [ file2 ...] target 


DESCRIPTION 
File? is copied (linked, moved) to target . Under no circumstance 
can file! and target be the same (take care when using sh (7) 
metacharacters). If target is a directory, then one or more files are 
copied (linked, moved) to that directory. If target is a file, its con- 
tents are destroyed. 


If mv or in determines that the mode of target forbids writing, it will 
print the mode (see chmod (2)), ask for a response, and read the 
standard input for one line; if the line begins with y , the mv or /n 
occurs, if permissable; if not, the command exits. No questions are 
asked and the mv or /n is done when the -f option is used or if the 
standard input is not a terminal. 


Only mv will allow file? to be a directory, in which case the directory 

ns rename will occur only if the two directories have the same parent; 
( ; file! is renamed target. If file7 is a file and target is a link to another - 
/ file with links, the other links remain and target becomes a new file. 


When using cp , if farget is not a file, a new file is created which 
has the same mode as file? except that the sticky bit is not set 
unless you are super-user; the owner and group of target are those 
of the user. If target is a file, copying a file into target does not 
change its mode, owner, nor group. The last modification time of 
target (and last access time, if target did not exist) and the last 
access time of file? are set to the time the copy was made. lf tar- 
get is a link to a file, all links remain and the file is changed. 


SEE ALSO 

cpio(1), rm(1). 

~ chmod(2) in the Sys5 UNIX Programmer Reference Manual. 

BUGS 
If file? and target lie on different file systems, mv must copy the file 
and delete the original. In this case any linking relationship with 
other files is lost. | 


Ln will not link across file systems. 


Pade 1: May 14, 1986 


CPIO(1) UNIX Sys5 CPIO(1) 


NAME _ 
cpio — copy file archives in and out : ae 


SYNOPSIS 
cpio —o [ acBv | 


cpio -—i [ BcdmrtuvfsSb6 | [ patterns ] 
cpio —p [ adimruv | directory 


DESCRIPTION 
Cpio —o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. Output is padded to a 512-byte 
boundary. 


Cpio -i (copy in) extracts files from the standard input, which is 
assumed to be the product of a previous cpio —o . Only files with 
names that match patterns are selected. Patterns are given in the 
name-generating notation of sh (7). In patterns , meta-characters ? 

, *, and[ ... ] match the slash / character. Multiple patterns may 

be specified. and if no patterns are specified, the default for patterns 

is * (ie., select all files). The extracted files are conditionally 
created and copied into the current directory tree based upon the 
options described below. The permissions of the files will be those’ 

of the previous cpio —o . The owner and group of the files will be ~~ 
that of the current user unless the user is super-user, which causes 
cpio to retain the owner and group of the files of the previous cpio 

—O. 


Cpio —p (pass) reads the standard input to obtain a list of path 
names of files that are conditionally created and copied into the des- 
tination directory tree based upon the options described below. 


The meanings of the available options are: 


a Reset access times of input files after they have been 
copied. 
B Input/output is to be blocked 5,120 bytes to the record 


(does not apply to the pass option; meaningful only with 
data directed to or from tape devices). 


d Directories are to be created as needed. 

c Write header information in ASCII character form for porta- 
bility. | 

r Interactively rename files. If the. user types a null line, the 
file is skipped. 

t Print a table of contents of the input. No files are created. < 

u Copy unconditionally (normally, an older file will not replace... _/ 
a newer file with the same name). 

Vv Verbose : causes alist of file names to be printed: When 


used with the t option, the table of contents looks like the 
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output of an Is —I command (see /s (7)). 


| Whenever possible, link files rather than copying them. 


Usable only with the —p option. 
m Retain previous file modification time. This option is ineffec- 
tive on directories that are being copied. 


f Copy in all files except those in patterns. 
s Swap bytes. Use only with the —i option. 
S Swap halfwords. Use only with the —i option. 
b Swap both bytes and halfwords. Use only with the -i 
option. 
EXAMPLES 


( - SEE ALSO 


BUGS 


The first example below copies the contents of a directory onto a 
tape in cpio archive format; the second duplicates a directory hierar- 
chy: | 
Is | cpio -o >/dev/rrm/Om 

cd olddir 

find . —depth —print | cpio —pdl newdir 

The trivial case “find . —depth -print | cpio -oB >/dev/rrm/Om” 
can be handled more efficiently by: 


find . —cpio /dev/rrm/Om 


ar(1), find(1), Is(1). 
cpio(4) in the Sys5 UNIX Programmer Reference Manual. 


Path names are restricted to 128 characters. If there are too many 
unique linked files, the program runs out of memory to keep track of 
them and, thereafter, linking information is lost. Only the super-user 
can copy special files. The —B option does not work with certain 
magnetic tape drives (see un32 (7) in the "Sys5 UNIX Administrator 
Reference Manual" ). 
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cpp — the C language preprocessor | 


SYNOPSIS 


Nib/epp [ option ... It ifile [ ofile ] ] 


DESCRIPTION 


Cpp is the C language preprocessor which is invoked as the first 
pass of any C compilation using the cc (1) command. Thus the out- 
put of cpp is designed to be in a form acceptable as input to the 
next pass of the C compiler. As the C language evolves, cpp and 


‘ the rest of the C compilation package will be modified to follow 


these changes. Therefore, the use of cpp other than in this frame- 


work is not suggested. The preferred way to invoke cpp is through © 
~ the cc (1) command, since the functionality of cop may someday 


be moved elsewhere. See m4 (1) for a general macro processor. 


Cpp optionally accepts two file names as arguments. /file and ofile 
are respectively the input and output for the preprocessor. They 
default to standard input and standard output if not supplied. 


~The following options to cpp are recognized: 


—P Preprocess the input without producing the line control infor- 
mation used by the next pass of the C compiler. 


ss 


—C By default, cpp strips C-style comments. If the -—C option is\—” 


specified, all comments (except those found on cpp direc- 
tive lines) are passed along. 


—Uname ‘ 
Remove any initial definition of name , where. name is a 
reserved symbol that is predefined: RY the particular prepro- 
cessor. -— 


—Dname 


-—Dname=def 
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Define name as if by a #define directive. If no =def is 
given, name is defined as 1. The —D option has lower pre- 
cedence than the —U option. That is, if the same name is 
used in both a —U option and a —D option, the name will be 
undefined regardless of the order of the options. 


—T Except on the PDP-11, preprocessor symbols are no longer 
restricted to eight characters. The -T option forces cpp to 
use only the first eight characters for distinguishing different 
preprocessor names. This behavior is the same as previ- 


ous preprocessors with respect to the length of names ancy % 
is included for backward compatability. / 
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-Idir Change the algorithm for searching for #include files 
whose names do not begin with / to look in dir before look- 
ing in the directories on the standard list. Thus, #include 
files whose names are enclosed in "" will be searched for 
first in the directory of the file with the #include line, then in 
directories named in —l options, and last in directories on a 
standard list. For #include files whose names are 
enclosed in <> , the directory of the file with the #include 
line is not searched. 


Two special names are understood by cop. The name __LINE__ its 
defined as the current line number (as a decimal integer) as known 
by cpp , and __FILE__ is defined as the current file name (as a C 
string) as known by cpp. They can be used anywhere (including in 
macros) just as any other defined name. 


All cpp directives start with lines begun by # . Any number of 
blanks and tabs are allowed between the # and the directive. The 
directives are: 


#define name token-string 
Replace subsequent instances of name with token-string . 


#define name( arg, ..., arg ) token-string 

Notice that there can be no space between name and the (. 
Replace subsequent instances of name followed by a(, a 
list of comma-separated set of tokens, and a ) by ftoken- 
string , where each occurrence of an arg in the token-string 
is replaced by the corresponding set of tokens in the 
comma-separated list. When a macro with arguments is 
expanded, the arguments are placed into the expanded 
token-string unchanged. After the entire token-string has 
been expanded, cpp re-starts its scan for names to expand 
at the beginning of newly created token-string . 


#undef name 
Cause the definition of name (if any) to be forgotten from 
now on. 


#include "filename" 

#include <filename > 
Include at this point the contents of filename (which will then 
be run through cpp ). When the <filename> notation is 
used, filename is only searched for in the standard places. 
See the -I option above for more detail. 


#line integer-constant "filename" 
Causes cpp to generate line control information for the next 
pass of the C compiler. /nteger-constant is the line number 
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of the next line and filename is the file where it comes from.’ 
lf “filename” is not given, the current file name is ee 


unchanged. 


#endif 
Ends a section of lines begun by a test directive (#if, 
#ifdef , or #ifndef ). Each test directive must have a 
matching #endif . 


#ifdef name 
The lines following will appear in the output if and only if 
name has been the subject of a previous #define without 
being the subject of an intervening #undef . 


#ifndef name 
The lines following will not appear in the output if and only if 
name has been the subject of a previous #define without 
being the subject of an intervening #undef . , 


_ #if constant-expression 


FILES 


Lines following will appear in the output if and only if the 
constant-expression evaluates to non-zero. All binary non- 
assignment C operators, the ?: operator, the unary — ,!, 


a . , fo 
and ~ operators are all legal in constant-expression. The; 
precedence of the operators is the same as defined by the ..~ 


C language. There is also a unary operator defined , which 
can be used in constant-expression in these two forms: 
defined ( name ) or defined name. This allows the utility 
of #ifdef and #ifndef in a #if directive. Only these 
operators, integer constants, and names which are known 
by cpp should be used in constant-expression . In particu- 
lar, the sizeof operator is not available. 


#else Reverses the notion of the test directive which matches this 
directive. So if lines previous to this directive are ignored, 
the following lines will appear in the output. And vice versa. 


The test directives and the possible #else directives can be nested. 


jusr/include standard directory for #include files 


SEE ALSO 


cc(1), m4(1). 


‘DIAGNOSTICS 
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The error messages produced by cpp are intended to be self- ~~ 
explanatory. The line number and filename where the error. | 


occurred are printed along with the diagnostic. 
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( “NOTES 

a When new-line characters were found in argument lists for macros 
to be expanded, previous versions of cpp put out the new-lines as 
they were found and expanded. The current version of cpp 
replaces these new-lines with blanks to alleviate problems that the 
previous versions had when this occurred. 


( . 
s 

/ 
, “ 


May 28, 1985 Page 4 


CRONTAB(1) UNIX Sys5 CRONTAB(1) 


NAME fo 
crontab - user crontab file | | oe! 


SYNOPSIS | : 
crontab [file] 
crontab -r_— 
crontab -l 

DESCRIPTION 
Crontab copies the specified file, or standard input if no file is speci- 
fied, into a directory that holds all users’ crontabs. The —r option 
removes a user's crontab from the crontab directory. Crontab —| will 
list the crontab file for the invoking user. 


A user is permitted to use crontab if their name appears in the file 
/usr/lib/cron/cron.allow. If that file does not exist, the file 
/usr/lib/cron/cron.deny is checked to determine if the user should 
be denied access to crontab. If neither file exists, only root is 
allowed to submit a job. If either file is at.deny, global usage is per- 
mitted. The allow/deny files consist of one user name per line. 


A crontab file consists of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the following: / 


\ 
. 


go 8 
/ 


minute (0-59), 

hour (Q--23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0= Sunday). 


Each of these patterns may be either an asterisk (meaning all legal 
values), or a list of elements separated by commas. An element is 
either a number, or two numbers separated by a minus sign (mean- 
ing an inclusive range). Note that the specification of days may be 
made by two fields (day of the month and day of the week). If both 
are specified as a list of elements, both are adhered to. For exam- 
ple, 0 0 1,15 * 1 would run a command on the first and fifteenth of 
each month, as well as on every Monday. To specify days by only 
one field, the other field should be set to * (for example, 0 O * * 1 
would run a command only on Mondays). 


The sixth field of a line in a crontab file is a string that is executed 
by the shell at the specified times. A percent character in this field 
(unless escaped by \) is translated to a new-line character. Only the«— ~ 
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( = first line (up to a % or end of line) of the command field is executed 
KS by the shell. The other lines are made available to the command as 
standard input. 


The shell is invoked from your $HOME directory with an argO of 
sh. Users who desire to have their . profile executed must explicitly 
do so in the crontab file. Cron supplies a default environment for 
every shell, defining HOME , LOGNAME , SHELL(=/bin/sh) , and 
PATH(= :/bin:/usr/bin:/usr/Ibin) . 


NOTE : Users should remember to redirect the standard output and 
standard error of their commands! lf this is not done, any generated 
output or errors will be mailed to the user. 


FILES 
/usr/lib/cron main cron directory 
/ust/spool/cron/crontabs spool area 
/ust/lib/cron/log accounting information 
/usr/lib/cron/cron.allow list of allowed users 
/usr/lib/cron/cron.deny list of denied users 

SEE ALSO 

sh(1). 
( _ cron(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 


crypt — encode/decode 


SYNOPSIS 


crypt [ password ] 


DESCRIPTION 


FILES | 
/dev/tty for typed key 

SEE ALSO 
ed(1), makekey(1), stty(1). 

BUGS | 
If output is piped to nroff and the encryption key is not given on the 
command line, crypt can leave terminal modes in a strange state 
(see stty (7)). | 
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Crypt reads from the standard ptt and writes on the standard out- 
put. The password is a key that selects a particular transformation. 
If no password is given, crypt demands a key from the terminal 
and turns off printing while the key is being typed in. Crypt encrypts 
and decrypts with the same key: | 


crypt key <clear >cypher 
crypt key <cypher | pr 
will print the clear. 


Files encrypted by crypt are eseable with those treated by the 
editor ed in encryption mode. 


The security of encrypted files depends on three factors: the funda- 
mental method must be hard to solve; direct search of the key 


space must be infeasible; “sneak paths’ by which keys or clear text 


can become visible must be minimized. 


Crypt implements a one-rotor machine designed along the lines of 


the German Enigma, but with a 256-element rotor. Methods of 
attack on such machines are known, but not widely; moreover the 
amount of work required is likely to be large. 


The transformation of a key into the internal settings of the machine 
is deliberately designed to be expensive, i.e., to take a substantial 
fraction of a second to compute. However, if keys are restricted to 
(say) three lower-case letters, then encrypted files can be read by 
expending only a substantial fraction of five minutes of machine 
time. 


Since the key is an argument to the crypt command, it is potentially 
visible to users executing ps (7) or a derivative. The choice of keys 
and key security are the most vulnerable aspect of crypt . 


J 
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and an attempt is made to decrypt the result, only the contents of 


( lf two or more files encrypted with the same key are concatenated 
the first of the original files will be decrypted correctly. 
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NAME | 7 oe od | > 

csh — a shell (command interpreter) with C-like syntax ( 

SYNOPSIS | | | | 
/usr/plx/esh [ —cefinstvVxX ] [ arg... ] 


DESCRIPTION 

Csh is a command language interpreter. When you invoke it, it first 
executes commands from the file .cshre in your home directory. If 
you are logging in, it also executes commands from the file .login 
there. Normally the shell then begins reading commands from the 
terminal, prompting with % (a per cent sign followed by a blank). 
Later in this manual entry, we will describe how the shell processes 
arguments and command scripts. 


The shell repeatedly reads a line of command input and breaks the 
line into words; places the sequence of words on the command his- 
tory list and parses it; and finally executes each command in the 
Current line. 


When a login C-shell terminates, it executes commands from the file 
-logout in your home directory. 


Lexical Structure 


The shell usually splits input lines into words at blanks and tabs. - 
The characters &, | ;, <, >, (, and ) are exceptions, however; they.” 
all form separate words. If doubled, as in &&, || <<, or >>, these 

pairs form single words. These parser metacharacters may be 
made part of other words; their special meaning may be turned off 

by preceding them with \. A newline preceded by a \ is equivalent 

to a blank. 


In addition, strings enclosed in matched pairs of quotations, *,~, or", 
form parts of a word; metacharacters in these strings, including 
blanks and tabs, do not form separate words. The semantics of 
these quotations are described below. Within pairs of \ or " charac- 
ters, a newline preceded by a \ gives a true newline character. 


When the shell’s input is not a terminal, the character # introduces 
a comment, which continues to the end of the input line. It is 
prevented this special meaning when preceded by \ and in quota- 
tions using ~, *, and ”. 

Commands 


A simple command is a sequence of words, the first of which speci- 
fies the command to be executed. A simple command or a 
sequence of simple commands separated by | characters forms a * 
pipeline. In a pipeline, the output of each command becomes the \__” 
input of the next. A command line may contain sequences of pipe- 
lines; separate the pipelines by ;, and they are then executed 
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sequentially. You do not necessarily have to wait for a sequence of 
pipelines to finish executing before you issue another command: by 
_ 7 following the command with an ampersand (&), the sequence of 
pipelines (0 or more) is executed in background mode, and you 
receive another shell prompt immediately. A command sequence 
followed by an ampersand is not terminated by a hangup signal; the 
nohup command need not be used. 


Commands or pipelines may be placed in parentheses ( ) to form 
another simple command (which may be a component of a pipeline, 
etc.) You may also separate pipelines with || or && indicating, as in 
the C language, that the second component is to be executed only if 
the first fails or succeeds respectively. (See Expressions.) 


Substitutions 
The shell performs various transformations on its input. 
History Substitutions 


History substitutions reintroduce sequences of words from previous 
commands. They may also perform modifications on these words. 
Thus history substitutions provide a generalization of a redo func- 
tion. 


History substitutions. begin with the character / and may begin any- . 
where in the input stream if a history substitution is not already in 
progress. This / may be preceded by an \ to prevent its special 
meaning; a / is passed unchanged when it is followed by a blank, 
tab, newline, = or (. History substitutions also occur when an input 
line begins with +. This special abbreviation is described later. 


Input lines containing history substitution metacharacters are 
echoed on the terminal before being executed. The echoed version 
shows the command line as it could have been typed without history 
substitution. 


The history mechanism saves some number of commands input 
from the terminal. The size of the history list thus created is con- 

trolled by the history variable. The immediately previous command 
_ is always retained. Commands are numbered sequentially from 1. 


For example,, consider the following output from the history com- 
mand: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. You don't 
always need to use event numbers when you use the history 
mechanism; if you want to see them for each command, the current 
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event number can be made part of the prompt by placing an tin the > 


prompt string. - 7 wl 
If the current event is number 13, you can refer to event 11 by its 
event number as in !11; by its event number relative to the current 
event number as in !—2; by a prefix of a command word as in !c; or 

by a string contained in a word in the command as in !?old?. 
These forms, without further modification, simply repeat the com- 
mand line of event 11. As a special case !! refers to the previous 
command; thus !! alone is essentially a redo. The form !# refers to 

the current command (the one being typed in). See below for an 
example of this in use. 


To select words from a previous command line, use a colon (:) and | 
a designator for the desired words. The words of a input line are 
numbered from 0, the first (usually command) word being 0, the 
second word (first argument) being 1, etc. The basic word designa- 
tors are: 


0 first (command) word 

nm. n'th argument 

t first argument, i.e. “1” 

$ last argument 

% word matched by (immediately preceding) ?s ? searc’ 
xX-y — range of words eee 
~y abbreviates “OQ—y” 

% abbreviates “'—$", or nothing if only 1 word in event 

X * abbreviates “x —$” 

xX— like “x *” but omitting word “$” 


Thus the command 
diff /usr/man/docs/vpm1.0 /usr/man/docs/vpm2.0 ; vi !#:1 


uses both the “!#” convention for the current command line, and the 
“sn” convention for argument number. The effect of this command 
is to display the differences between the two files on the standard 
output, and then summon the editor vi for use on the first file (argu- 
ment number 1). 


The : separating the event specification from the word designator 

can be omitted if the argument selector begins with a t, $, *, -, or 

%. So, in the example above, the vi portion could have been 
equivalently typed 

ae. 
vi |#° : 
A sequence of modifiers can be placed after the optional word 
designator. Each modifier is preceded by a :. The following modif- 
lers are defined: 


\ ; : 
a, a. 
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h Remove a trailing pathname component, leaving the head. 

r Remove a trailing .xxx component, leaving the root name. 
s/[/r/ Substitute / for r 

t Remove all leading pathname components, leaving the tail. 
& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. g&. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 
x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a g the modification is applied only to the first 
modifiable word. It is always an error for no word to be applicable. 


Expressions on the left hand side of substitutions are not regular 
expressions in the sense of the editors; rather, they are strings. 
Any character may be used as the delimiter in place of /; a \ quotes 
the delimiter. The character & in the right hand side is replaced by 
the text from the left. A \ quotes & also. A null / (left hand side 
expression) uses the previous string either from a/ or from a con- 
textual scan string s in !?s?. The trailing delimiter in the substitu- 
tion may be omitted if a newline follows immediately; the same goes 
for the trailing ? in a contextual scan. 


You can use a history reference without an event specification, e.g. . 
1$. In this case the reference is to the previous command unless a 
previous history reference occurred on the same line in which case 
this form repeats the previous reference. Thus !?foo?t !$ gives the 
first and last arguments from the command matching ?f00?. 


A special abbreviation of a history reference occurs when the first 
non-blank character of an input line is a t. This is equivalent to !:st, 
providing a convenient shorthand for substitutions on the text of the 
previous line. Thus tlbtlib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be surrounded with { 
and } to insulate it from the characters that follow. Thus, after Is 
“sandy we might do {{I}1 to get Is “sandy1, while !11 would look for 
a command starting I1. 


Quotations with ’ and " 


The quotation of strings by ’ and " can prevent all or some substitu- 
tions. Strings enclosed in ’ are prevented any further interpretation. 
Strings enclosed in " are variable and command expanded as 
described below. 


In both cases the resulting text becomes (all or part of) a single — 
word; only in one special case (see Command Substitition below) 
does a " quoted string yield parts of more than one word; ’ quoted 
strings never do. 
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Alias Substitution | a 


The shell maintains a list of aliases that can be established,\__/ 
displayed and modified by the alias and unalias commands. After 
scanning a command line, the C shell parses it into distinct com- 
mands and checks the first word of each command, left-to-right, to 

see if it has an alias. If it does, then the text that is the alias for that 
command is reread as though that command were the previous 
input line. The history mechanism remains fully operational within 
aliasing. The resulting words replace the command and argument 

list. 


Thus if the alias for Is is Is -l, the command Is /usr becomes Is -I 
/usr. The argument list here is undisturbed. Similarly if the alias for . 
lookup is grep !t /etc/passwd, then lookup bill becomes grep bill 
/etc/passwd. 


If the C shell finds an alias, it transforms the words of the input text 
and begins the aliasing process again on the reformed input line. If 
the first word of the new text is the same as the old, the shell flags it 
to prevent further aliasing. Other loops are detected and cause an 
error. 


Note that the mechanism allows aliases to introduce parser, ~ 
metasyntax. Thus we can alias print \flpr \!* | Ipr\f1 to make a_ 
command that prs its arguments to the line printer. : 


Variable Substitution 


The shell maintains a set of variables, each of which has as value a 
list of zero or more words. Some of these variables are set by the 
shell or referred to by it. For instance, the argv variable is an image 
of the shell’s argument list, and words of this variable’s value are 
referred to in special ways. For a complete list of the shell’s pre- 
defined variables, see the section Pre-defined Variables towards the 
end of this manual entry. 


The values of variables may be displayed and changed by using the 
set and unset commands. A number of the variables referred to by 
the shell are toggles; the shell does not care what their value is, 
only whether they are set or not. For instance, the verbose variable 
is a toggle that causes command input to be echoed. The setting of 
this variable results from the —v command line option. 


Other operations treat variables numerically. The @ command per- 

mits numeric calculations to be performed and the result assigned to 

a variable. Variable values are, however, always represented as ¢—~ 
(zero or more) strings. For the purposes of numeric operations, the fe y 
null string is considered to be zero, and the second and subsequent ~~ 
words of multiword values are ignored. | 
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After alaising and parsing the input line, and before executing each 
command, the shell performs variable substitution, keyed by $ char- 
acters. This expansion can be prevented by preceding the $ with a 
\, except within always occurs, and within “‘fRs where it never 
occurs. Strings quoted by ~ are interpreted later (see Command 
Substitution below) so $ substitution does not occur there until later, 
if at all. A $ is passed unchanged if followed by a blank, tab, or 
end-of-line. 


Input/output redirections are recognized before variable expansion, 
and are variable-expanded separately. With no |/O redirection, the 
command name and entire argument list are expanded together. 
Thus the first (command) word may generate more than one word, 
the first of which becomes the command name, and the rest of 
which become arguments. 


Unless enclosed in " or given the :q modifier, the results of variable 
substitution may eventually be command and filename substituted. 
Within ", a variable whose value consists of multiple words expands 
to a (portion of) a single word, with the words of the variable’s value 
separated by blanks. When the :q modifier is applied to a substitu- 
tion, the variable expands to multiple words, with each word 
separated by a blank and quoted to pievels later command or 

filename substitution. | 


The following metasequences are provided for introducing variable 
values into the shell input. Except as noted, it is an error to refer to 
a variable that is not set. 


$name 
${name} 


Are replaced by the words of the value of variable name, 
each separated by a blank. Braces insulate name from fol- 
lowing characters that would otherwise be part of it. Shell 
variables have names consisting of up to 20 letters, digits, 
and underscores. 


lf name is not a shell variable, but is set in the environment, 
then that value is returned (but : modifiers and the other 
forms given below are not available in this case). 


$namef[selector] 
${name[selector]} 


May be used to select only some of the words from the 
value of name. The selector is subjected to $ substitution 
and may consist of a single number or two numbers 
separated by a -. The first word of a variable’s value is 
numbered 1. If the first number of a range is omitted, it 
defaults to 1. If the last member of a range is omitted, it 
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defaults to $#name. The selector * selects all words. It is.- 
not an error for a range to be empty if the second argument, J 
is omitted or in range. ne 


$#name 
${#name} 


Gives the number of words in the variable. This is useful for 
later use in a [selector]. 

$0 | 
Substitutes the name of the file from which command input 
is being read. An error occurs if the name is not known. 


$number 
${number} 


Equivalent to $argv[number]. 
$x 

Equivalent to $argv[*]. 
The modifiers :h, :t, :r, :q and :x may be applied to the substitutions 
above as may :gh, :gt and :gr. If braces { } appear in the com- 
mand form, the modifiers must appear within the braces. The ~~ 


current implementation allows only one : modifier on each $ expan- | 
sion. ad 


The following substitutions may not be modified with : modifiers. 


$?name 
${?name} 


Substitutes the string “1” if name is set, “O” if it is not. 
$20 


Substitutes “1” if the current input filename is known, “O” if 
it is not. 


$$ 


Substitute the (decimal) process number of the (parent) 
shell. 


Command and Filename Substitution 


Command and filename substitutions are applied selectively to the 
arguments of built-in commands. This means that portions of 
expressions that are not evaluated are not subjected to these 
expansions. For commands not internal to the shell, the command “a Hie 
name is substituted separately from the argument list. This occurs | 

very late, after input-output redirection is performed, and in a child “~ 
of the main shell. 
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Command Substitution 


“ 


Enclosing a command in ~ indicates command substitution. The 
shell breaks the output from such a command into separate words 
at blanks, tabs and newlines; it discards null words. It then replaces 
the original string with this text. Within "s, only newlines force new 
words; blanks and tabs are preserved. 


In any case, the single final newline does not force a new word. 
Thus a command substitution may yield only part of a word, even if 
the command outputs a complete line. 


Filename Substitution 


If a word contains any of the characters +, ?, [ or { or begins with 
the character ~, then that word is a candidate for filename substitu- 
tion, also known as globbing. This word is then regarded as a pat- 
tern, and replaced with an alphabetically sorted list of file names 
that match the pattern. If several words on the same command line 
specify filename substitution, the C shell returns an error only if no 
pattern matches an existing file name. It does not return an error if 
some matches are successful and others are not. Only the meta- 
characters *, ? and [ imply pattern matching; the characters ~ and { 
being more akin to abbreviations. 


In matching filenames, the character . at the beginning of a filename _ 
or immediately following a /, as well as the character /, must be 
matched explicitly. The character * matches any string of charac- 
ters, including the null string. The character ? matches any single 
character. The sequence [...] matches any one of the characters 
enclosed. Within [...], a pair of characters separated by — matches 
any character lexically between the two. 


The character ~ at the beginning of a filename refers to home direc- 
tories. Standing alone, i.e. ~, it expands to the invoker’s home direc- 
tory as reflected in the value of the variable home. When followed 
by a name consisting of letters, digits and — characters the shell 
searches for a user with that name and substitutes his home direc- 
tory; thus “ken might expand to /usr/ken and “ken/chmach to 
/usr/ken/chmach. If the character ~ is followed by a character other 
than a letter or / or appears someplace other than at the beginning 
of a word, it is left undisturbed. 


The metanotation a{b,c,d}e is a shorthand for abe ace ade. The 
shell preserves left to right order, and sorts the results of matches 
separately at a low level to preserve this order. This construct may 
be nested. Thus, ~source/st/{oldls,is}.c expands to 
/usr/source/st/oldis.c /usr/source/s1/Is.c._ This works whether or 
not these files exist. There is no chance of error if the home direc- 
tory for source is /usr/source. Similarly ..{memo,*box} might 
expand to ../memo ../pox ../mbox. (Note that memo is not sorted 
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with the results of matching *box.) As a special case {, } and {} are — _ 
passed undisturbed. 


‘ Pe: 
RS ye 


Input/Output - 
The standard input and standard output of a command may be 
redirected with the following syntax: 


< name 


Open file name (which is first variable, command and_ 
filename expanded) as the standard input. 


<< word 


Read the shell input up to a line identical to word. The shell 
does not perform variable, filename or command substitu- | 
tion on word. It compares each input line to word before 
doing any substitutions on this input line. Unless a quoting 
\, ", “ or ~ appears in word, the shell performs variable and 
command substitution on the intervening lines, allowing \ to 
quote $, \ and ~. Commands that are substituted have all 
blanks, tabs, and newlines preserved, except for the final 
newline, which is dropped. The shell places the resultant 
text in an anonymous temporary file, which it then gives to _ 
the command as standard input. ( 


> name 
>! name 
>& name 
>&! name 


The file name is used as standard output. If the file does 
not exist, it is created; if the file exists, its previous contents 
are lost. 


The variable noclobber is designed to prevent accidental 
overwriting of files by ">". If the variable noc/obber is set, 
then the file named by name must either not exist or be a 
character special file (e.g. a terminal or /dev/nulf); other- 
wise, noclobber prevents the redirection and issues an error 
message. The ! forms suppress this check. 


The forms involving & route the diagnostic output into the 
specified file as well as the standard output. Name is 
expanded in the same way as < input filenames are. 


>> name 

>>& name oa 
>>!name Lo 
>>&! name cs 


Uses file name as standard output like > but places output 
at the end of the file. If the variable noc/lobber is set, then it 
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is an error for the file not to exist unless one of the ! forms 
is given. Otherwise similar to >. 


lf a simple command is run in foreground mode, without being fol- 
lowed by &, its environment is that of the shell that runs it. If a shell 
procedure is run in foreground mode, without being followed by &, 
each command within the procedure receives the environment in 
which the procedure was invoked. In other words, the shell spawned 
by the shell procedure inherits the environment of the shell that 
spawned it. This environment may be modified by command-line 
factors such as input-output parameters or the presence of the com- 
mand in a pipeline. Thus commands run from within a shell pro- 
cedure receive the standard input of the shell that is running the 
script; commands within a shell script know nothing about each 
other. Since we often want a command within a shell script to 
receive standard input not from the shell that runs the script but 
from within the script itself, we need a way to present such inline 
data. The << mechanism serves this function. It permits shell 
command scripts to function as components of pipelines and allows 
the shell to block read its input. See An Introduction to the C Shell 
for examples of the use of the << mechanism. 


If a command or shell procedure is run detached (followed by &), its 
default standard input is the empty file /dev/null. . 


Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form |& rather than just | 


Expressions 


A number of the shell’s built-in commands (described in the section 
“Built-in Commands” below) take expressions, in which the opera- 
tors are similar to those of C, with the same precedence. Built-in 
commands that take expressions include @, exit, if, and while. The 
following operators are available for use within expressions: 


| && lt & == l= <= >= < > 
<< >> +-—-* /%!7~ () 


In this list the precedence increases to the right, and down, == and 
l=, <= >= < and >, << and >>, + and-, * / and % being, in 
groups, at the same level. The == and != operators compare their 
arguments as strings; all others operate on numbers. Strings that 
begin with 0 are considered octal numbers. The shell evaluates null 
or missing arguments as 0. The results of all expressions are 
strings, which represent decimal numbers. Components of expres- 
sions should be surrounded by spaces; this always matters, except 
when components are adjacent to & | <, >, (, or), which are syn- 
tactically significant to the parser. 
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Command executions enclosed in { and } and file enquiries are also —~ 
available in expressions as primitive operands. File enquiries take J 
the form “— 1 name”, where / is one of: a 


read access 
write access 
execute access 
existence 
ownership 

zero size 

plain file 
directory 


Q*NOOxs 7 


“Name” is command and filename expanded and then tested to see | 
if it has the specified relationship to the real user. If the file does 
not exist or is inaccessible, all enquiries return false, i.e., 0. 


Command executions succeed, returning true, i.e., 1, if the com- 
mand exits with status 0; otherwise they fail, returning false, i.e. 0. 
If you want more detailed status information about a command, exe- 
cute the command outside of an expression and examine the vari- 
able status. 


Control Flow oN 


The shell contains commands that can regulate the flow of controlin. 
command files (shell scripts) and (in limited but useful ways) from 
terminal input. These commands all operate by forcing the shell to 
reread or skip in its input. Due to the implementation, the shell res- 
tricts the placement of some of the commands. 


The foreach, switch, and while statements, as well as the 
if-then-else form of the if statement require that the major key- 
words appear in a single simple command on an input line as shown 
below. 


If the shell’s input is not seekable, the shell buffers up input when- 
ever a loop is being read and performs seeks in this internal buffer 
to accomplish the rereading implied by the loop. (To the extent that 
this allows, backward goto’s succeed on non-seekable inputs.) 


Built-in Commands 


Built-in commands are executed within the shell. If a built-in com- 
mand occurs as any component of a pipeline except the last, it is 
executed in a subshell. 


alias 
alias name 
- alias name wordlist ees 


aN 
jie 


The first form prints all aliases. The second form prints the 
alias for “name”. The final form assigns the specified 
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wordlist as the alias of name; wordlist is command and 
filename substituted. Name may not be alias or unalias 


break 


Causes execution to resume after the end of the nearest 
enclosing forall or while. The remaining commands on the 
current line are executed. Multi-level breaks are thus possi- 
ble by writing them all on one line. 


breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 


cd 

cd name 
chdir 

chdir name 


Change the shell’s working directory to directory name. If no 
argument is given then change to the home directory of the 
user. 


If name is not found as a subdirectory of the current direc- - 
tory (and does not begin with /, ./, or ../), each component of 
the variable cdpath is checked to see if it has a subdirec- 
tory name. Finally, if all else fails but name is a shell vari- 
able whose value begins with /, then this is tried to see if it 
is a directory. 


continue 


Continue execution of the nearest enclosing while or 
foreach. The rest of the commands on the current line are 
executed. 


default: 


Labels the default case in a switch statement. The default 
should come after all case labels. 


echo wordlist 


The specified words are written to the shell’s standard out- 
put. A \e causes the echo to complete without printing a 
newline, akin to the \c in nroff(1). A \n in wordlist causes a 
newline to be printed. 


else 
end 
endif 
endsw 
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See the description of the foreach, if, switch, and Wnts _ 


statements below. : 
— 


exec command 


exit 


The specified command is executed in place of the current 
shell. 


exit(expr) 


The shell exits either with the value of the status variable 
(first form) or with the value of the specified expr (second 
form). 


foreach name (wordlist) 


end 


The variable name is successively set to each member of 
wordlist and the sequence of commands between this com- 
mand and the matching end are executed. (Both foreach 
and end must appear alone on separate lines.) 


The built-in command continue continues the loop prema- 
turely and the built-in command break terminates it prema- 
turely. When the C shell reads a foreach command from > 
the terminal, it reads the loop once and prompts with ?<—~ 
before executing any statements in the loop. If you make a 
mistake typing in a loop at the terminal, you can rub it out. 


glob wordlist 


Like echo but no \ escapes are recognized and words are 
delimited by null characters in the output. Useful for pro- 
grams that use the shell to filename expand a list of words. 


goto word 


history 


The specified word is filename and command expanded to 
yield a string of the form /abe/. The shell rewinds its input 
as much as possible and searches for a line of the form 
label:, possibly preceded by blanks or tabs. Execution con- 
tinues after the /abel line. 


Displays the history event list. 


if (expr) command 
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If the specified expression evaluates true, then the singler ~ 
command with arguments is executed. Variable substitutions . 
on command happens early, at the same time as for the 
rest of the ff command. Command must be a simple 
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| parenthesized command list. Input/output redirection occurs 
_ even if expr is false, when command is not executed (this is 
a bug). 


( a command--not a _ pipeline, a command list, or a 
| } 


if (expr) then 
else if (expr2) then 


else 


endif 
If the specified expr is true then all the commands up to the 
first else are executed; if expr2 is true then the commands 
to the second else are executed, etc. Any number of else-if 
pairs are possible; only one endif is needed. The else part 
is likewise optional. (The words e/se and endif must appear 
at the beginning of input lines; the /f must appear alone on 
its input line or after an else. ) 

login 
Terminate a login shell, replacing it with an instance of 
/bin/login. This is one way to log off, included for compati- - 
bility with /bin/sh. 

logout 
Terminate a login shell. Especially useful if ignoreeof is set. 

nice 


nice +number 
nice command 
nice +number command 


The first form sets the nice for this shell to 4. The second 
form sets the nice to the given number. The final two forms 
run command at priority 4 and number respectively. The 
super-user may specify negative niceness by using nice 


—number .... Command is always executed in a sub-shell, 
and the restrictions on commands in simple if statements 
apply. 


nohup 
nohup command 


Shell scripts use the first form to cause hangups to be 
ignored for the remainder of the script. The second form 
causes the specified command to be run with hangups 
ignored. Unless the shell is running detached, nohup has no 
effect. All processes detached with & are automatically 
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nohuped. (Thus, nohup is not really needed.) Pa 


The SYSTEM II! utility /bin/nohup is incompatible with the. 
csh nohup. Therefore, to use the SYSTEM Ill command, 
you must invoke it with its full pathname. 


onintr 
onintr — 
onintr label 


Control the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts (i.e., to 
terminate shell scripts or return to the terminal command 
input level). The second form onintr — causes all interrupts 
to be ignored. The final form causes the shell to execute a © 
goto label when an interrupt is received or a child process 
terminates because it was interrupted. 


In any case, if the shell is running detached and interrupts 
are being ignored, all forms of onintr have no meaning and 
interrupts continue to be ignored by the shell and all invoked 
commands. 


rehash 
Causes the internal hash table of the contents of the direc- (— ‘ 


tories in the path variable to be recomputed. This is needed .” 
if new commands are added to directories in the path while 

you are logged in. This should only be necessary if you add 
commands to one of your own directories, or if a systems 
programmer changes the contents of one of the system 
directories. 


repeat count command 


The specified command (which is subject to the same res- 
trictions as the command in the one-line if statement 
above), is executed count times. 1/O redirection occurs 
exactly once, even if count is 0. 


set 

set name 

set name=word 

set name[index]=word 
set name = (wordlist) 


The first form of the command shows the value of all shell 
variables. Variables that have other than a single word as 
value print as a parenthesized word list. The second form a : 
sets name to the null string. The third form sets name to “— ° 
the single word. The fourth form sets the indexth com- 
ponent of name to word; this component must already exist. 
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a The final form sets name to the list of words in wordlist. In 
( 7 all cases the value is command and filename expanded. 


These arguments may be repeated to set multiple values in 
a single set command. Note however, that variable expan- 
sion happens for all arguments before any setting occurs. 


setenv name value 


(Version 7 systems only.) Sets the value of environment 
variable name to be value, a single string. Useful environ- 
ment variables are TERM, the type of your terminal, and 
SHELL, the shell you are using. 


shift 
shift variable 


The members of argv are shifted to the left, discarding 
argv{1]. It is an error for argv not to be set or to have less 
than one word as value. The second form performs the 
same function on the specified variable. 


source name 


The shell reads commands from name. Source commands 
may be nested; if they are nested too deeply the shell may 
run out of file descriptors. An error in a source at any level © 
terminates all nested source commands. Input during 
source commands is never placed on the history list. 


switch (string) 
case str1: 


breaksw 
default: 


breaksw 
endsw 


Each case label is successively matched against the speci- 
fied string, which is first command and filename expanded. 
The file metacharacters *, ? and [...] may be used in the 
case labels, which are variable expanded. If none of the 
labels match before a default label is found, then the exe- 
cution begins after the default label. Each case label and 
the default label must appear at the beginning of a line. The 
command breaksw causes execution to continue after the 
endsw. Otherwise control may fall through case labels and 
default labels as in C. If no label matches and there is no 
default, execution continues after the endsw. 
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time om 

time command | i \ 
With no argument, the shell prints a summary of time used 
by this shell and its children. With arguments, the shell 
times the specified simple command and prints a time sum- 
mary as described under the time variable. If necessary, an 
extra shell is created to print the time statistic when the 
command completes. 

umask 

umask value 


The file creation mask is displayed (first form) or set to the 
specified value (second form). The mask is given in octal. 
Common values for the mask are 002, giving all access to 
the group and read and execute access to others; or 022, 
giving all access except no write access for users in the 
group or others. 


unalias pattern 


unhash 


The shell discards all aliases whose names match the 
specified pattern. Thus all aliases are removed by unalias 
*. It is not an error for nothing to be unaliased. ae 


Use of the internal hash table to speed location of executed 
programs is disabled. 


unset pattern 


wait 


The shell removes all variables whose names match the 
specified pattern. Thus all variables are removed by unset 
*: this can have distasteful side-effects. It is not an error for 
nothing to be unset. 


The shell waits for all child processes. If the shell is interac- 
tive, then an interrupt can disrupt the wait, at which time the 
shell prints names and process numbers of all children 
known to be outstanding. 


while (expr) 


end 
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While the specified expression evaluates non-zero, the com- 
mands between the while and the matching end are* ~ 
evaluated. Break and continue can terminate or continue / 
the loop prematurely. (The while and end must appear 
alone on their input lines.) If the input is from a terminal, 
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prompting occurs here the first time through the loop as for 
the foreach statement. 


@ 
@ name = expr 
@ name[index] = expr 


The first form prints the values of all the shell variables. 
The second form sets the specified name to the value of 
expr. If the expression contains <, >, & or |, then at least 
this part of the expression must be placed within 
parentheses (). The third form assigns the value of expr to 
the indexth argument of name. Both name and its indexth 
component must already exist. 


The operators *=, +=, etc are available as in C. The 
space separating the name from the assignment operator is 
optional. Spaces are, however, mandatory in separating 
components of expr that would otherwise be single words. 


Special postfix ++ and — operators increment and decre- 
ment name respectively, i.e. @ i++. 


Pre-defined Variables 


The following variables have special meaning to the shell. Of these, . 
the shell always sets argv, child, home, path, prompt, shell and 
Status. This setting occurs only at initialization, except for child and 
Status. Variables set by the shell are not subsequently modified by 
the shell, though the user may explicitly modify them. 


The shell copies the environment variable PATH into the variable 
path, and copies the value back into the environment whenever 
path is set. Thus you need not worry about its setting other than in 
the file .cshrc, because inferior csh processes import the definition 
of path from the environment. 


argv Set to the arguments to the shell, it is from this 
variable that positional parameters are substituted, 
i.e. $7 is replaced by $argv/1], etc. 


cdpath Specifies a list of alternate directories to be 
searched by chdir commands. 


child The process number printed when the last com- 
mand was forked with & This variable is unset 
when this process terminates. | 


yan echo Set when the -—x command line option is given. 

( | Causes each command and its arguments to be 
ee echoed just before it is executed. For non-built-in 

commands, all expansions occur before echoing. 

Builtin commands are echoed before command 
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histchars 


history 


home 
ignoreeof — 


mail 


noclobber 


noglob 


nonomatch 
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and filename substitution, since these substitutions _ a ~ 


are then done selectively. 


Can be assigned a two character string. The first 
character is used as a history character in place of 
!, the second character is used in place of the * 
substitution mechanism. For example, set 
histchars=",;". makes the history characters a 
comma and semicolon. 


Takes a numeric value that controls the size of the 
history list. The shell does not discard any com- 
mand referenced in this many events. Too large 
values of history may run the shell out of memory. 
The last executed command is always saved on 
the history list. 


The home directory of the invoker, initialized from 
the environment. The filename expansion of ~ 
refers to this variable. 


If set, the shell ignores end-of-file from input dev- 
ices that are terminals. This prevents shells from 
accidentally being killed by control-Ds. 


The files where the shell checks for mail. The shell | 


checks for mail after each command completion 
that results in a prompt, if a specified interval has 
elapsed. If any of these files exists with an access 
time not greater than its modify time, the shell 


sends the message “You have new mail.” 


If the first word of the value of mai! is numeric it 
specifies a mail checking interval, in seconds, dif- 
ferent from the default, which is 10 minutes. 


If multiple mail files are specified, then the shell 
says New mail in name when there is mail in the 
file name. 


As described in the section on /nput/output, restric- 
tions are placed on output redirection to insure that 
files are not accidentally destroyed, and that >> 
redirections refer to existing files. 


If set, filename expansion is inhibited. This is most 
useful in shell scripts that do not deal with 
filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 


If set, it is not an error for a filename expansion to 
not match any existing files; rather the primitive 
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pattern is returned. It is still an error for the primi- 
tive pattern to be malformed, i.e. echo [| still gives 
an error. 


Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If no 
path variable is specified, only full path names 
work. The usual search path is ., /bin and /usr/bin, 
but this may vary from system to system. For the 
super-user the default search path is /etc, /bin and 
/usr/bin. A shell that is given neither the —c¢ nor the 
—t option will normally hash the contents of the 
directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new 
commands are added to these directories while the 
shell is active, it may be necessary to give the 
rehash or the commands may not be found. 


The string printed before each command is read 
from an interactive terminal input. If a / appears in 
the string it is replaced by the current event 
number unless a preceding \ is given. Default is % 

, or # for the super-user. 


The file in which the shell resides. This is used in 
forking shells to interpret files which have execute 
bits set, but which are not executable by the sys- 
tem. (See the description of Non-built-in Com- 
mand Execution .below.) Initialized to the (system- 
dependent) home of the shell. 


The status returned by the last command. If it ter- 
minated abnormally, then 0200 is added to the 
status. Built-in commands that fail return exit 
status 1, all other built-in commands set status 0. 


Controls automatic timing of commands. Time 
takes a numeric argument, which stands for some 
number of CPU seconds. If time is set, the shell 
prints a line of information when any command tak- 
ing more than this many CPU seconds terminates. 
The line gives user, system, and real times, and a 
utilization percentage, which is the ratio of user 
plus system times to real time. 


Set by the —v command line option, causes the 
words of each command to be printed after history 
substitution. 
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Non-built-in Command Execution oe 
‘. 


When the shell finds that a command to be executed is not a built-in, 
command, it tries to execute the command via exec(2). Each word SA 
in the variable path names a directory from which the shell attempts 

to execute the command. If it is given neither a —c nor a —t option, 

the shell hashes the names in these directories into an internal table 

so that it only tries an exec in a directory if there is a possibility that 

the command resides there. This greatly speeds command location 
when the search path contains a large number of directories. If this 
mechanism has been turned off (via unhash), or if the shell is given 

a —c or -t argument, and in any case for each directory component 

of path that does not begin with a /, the shell tries to concatenates 

all the path entries with the given command name to form a path 
name of a file, which it then attempts to execute. 


Parenthesized commands are always executed in a subshell. Thus 
(cd ; pwd) ; pwd does not leave you in the home directory; it 
leaves you where you are, and prints the home directory name fol- 
lowed by the name of the directory you are in. cd ; pwd, on the 
other hand, leaves you in the home directory. Parenthesized com- 
mands are most often used to prevent chdir from affecting the 
current shell. 


If the file has execute permissions but is not an executable binary to’ 
the system, then it is assumed to be a file containing shell com- 
mands and a new shell is spawned to read tt. 


If there is an alias for shell then the words of the alias are 
prepended to the argument list to form the shell command. The first 
word of the alias should be the full path name of the shell (e.g. 
$shell). Note that this is a special, late-occurring, case of alias sub- 
stitution, and only allows words to be prepended to the argument list 
without modification. 


Argument List Processing 


lf argument O to the shell is —, then this shell is a login shell. The 
flag arguments are interpreted as follows: 


-c Commands are read from the (single) following argument, 
which must be present. Any remaining arguments are placed 
In argv. 


-e The shell exits if any invoked command terminates abnormally 
or yields a non-zero exit status. 


-f The shell starts faster, because it neither searches for nor gor 
executes commands from the file .cshre in the invoker's home’ 
directory. va 
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-i The shell is interactive and prompts for its top-level input, even 
if it appears not to be a terminal. Shells are interactive without 
this option if their inputs and outputs are terminals. 


—n Commands are parsed, but not executed. This may aid in 
syntactic checking of shell scripts. 


~s Command input is taken from the standard input. 


-—t A single line of input is read and executed. A \ escapes the 
newline at the end of this line to continue onto another line. 


-v Causes the verbose variable to be set, so command input is 
- echoed after history substitution. 


—-x Causes the echo variable to be set, so commands are echoed 
immediately before execution. 


-V Causes the verbose variable to be set even before .cshrc is 
executed. 


-X Is to —-x as -V is to -v. 


After processing of flag arguments, if arguments remain but none of 
the -c, —i, —s, or -t options is given, the first argument is taken as 
the name of a file of commands to be executed. The shell opens 
this file, and saves its name for possible resubstitution by $0. Many | 
system shell procedures are written for use with the standard Sys5, 
whose shell scripts are not compatible with this shell. Therefore, the 
C shell executes such a standard shell if the first character of a 
script is not a #, i.e., if the script does not start with a comment. 
Remaining arguments initialize the variable argv. 


Signal Handling 


The shell normally ignores quit signals. It ignores interrupt signals 
as well if the command is followed by &; otherwise the signals have 
the values the shell inherited from its parent. The shell’s handling of 
interrupts can be controlled by onintr. Login shells catch the ter- 
minate signal; otherwise this signal is passed on to children from the 
state in the shell’s parent. No interrupts are allowed when a login 
shell is reading the file ./ogout. 


FILES 
“/.cshre Read at beginning of execution by each shell. 
“/.login Read by login shell, after .cshrce at login. 
“/.logout Read by login shell, at logout. 
/bin/sh Standard shell, for shell scripts not 
starting with a #. 
/tmp/sh« Temporary file for <<. 
/dev/null Source of empty file. 
/etc/passwd Source of home directories for “name. 
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LIMITATIONS on™ 
Words can be no longer than 512 characters. The number of char- ; 
acters in an argument varies from system to system. The number “—~ 
of arguments to a command involving filename expansion is limited 
to 1/6th the number of characters allowed in an argument list. Also 
command substitutions may substitute no more characters than are 
allowed in an argument list. 


To detect looping, the shell restricts the number of alias substititu- 
tions on a single line to 20. 


NOTES 
The Plexus version of the C Shell is based on the one from the 
University of California at Berkeley. 


SEE ALSO 
access(2), exec(2), fork(2), pipe(2), signal(2), umask(2), wait(2), 
a.out(4), environ(5), An Introduction to the C Shell. 


BUGS 
Control structure should be parsed rather than being recognized as 
built-in commands. This would allow control commands to be placed 
anywhere, to be combined with | and to be used with & and ; 
metasyntax. 


Commands within loops, prompted for by ?, are not placed in the . J 
history list. i 


It should be possible to use the : modifiers on the output of com- 
mand substitutions. More than one : modifier should be allowed on 
$ substitutions. 


Some commands should not touch status or it may be so transient 
as to be almost useless. Or-ing in 0200 to status on abnormal ter- 
mination is not elegant. 


The new exec command inherits several open files other than the 
normal standard input and output and diagnostic output. If the input 
and output are redirected and the new command does not close 
these files, some files may be held open unnecessarily. 


A number of bugs are associated with the importing/exporting of the 
PATH. For example, directories in the path using the ~ syntax are 
not expanded in the PATH. Unusual paths, such as (), can cause 
csh to dump core. 


This version of csh does not support or use the process control 
features of the 4th Berkeley Distribution. It contains a number of 
known bugs that have been fixed in the process control version. 


a 
Hy 
/ 
7 


/ 
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NAME 
| csplit — context split 
~ SYNOPSIS 
csplit [-—s] [-k] [-f prefix] file argi [... argn] 
DESCRIPTION 
Csplit reads file and separates it into n+1 sections, defined by the 
arguments arg? ... argn . By default the sections are placed in 
xx00 ... xxn (nN may not be greater than 99). These sections get 
the following pieces of file : 
00: From the start of file up to (but not including) the line 
referenced by arg7 . 

01: From the line referenced by arg7 up to the line refer- 

enced by arg2. 

n+1: From the line referenced by argn to the end of file . 

If the file argument is a — then standard input is used. 
The options to cspilit are: 
— -S Csplit normally prints the character counts for each . 
( file created. If the -—s option is present, csplit 
suppresses the printing of all character counts. 

—k Csplit normally removes created files if an error 
occurs. If the —k option is present, csplit leaves 
previously created files intact. 

-f prefix \f the -f option is used, the created files are named 
prefix00 ... prefixn. The default is xx00 ... xxn. 

The arguments (arg? ... argn ) to csplit can be a combination of 
the following: 

lrexp/ AQ file is to be created for the section from the 
current line up to (but not including) the line contain- 
ing the regular expression rexp . The current line 
becomes the line containing rexp . This argument 
may be followed by an optional + or — some 
number of lines (e.g., /Page/—5). 

“ole XP Yo 
This argument is the same as /rexp/, except that no 

; file is created for the section. 
( | Inno A file is to be created from the current line up to (but 


not including) /nno . The current line becomes /nno . 
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{num} Repeat argument. This argument may follow any of _ 
the above arguments. If it follows a rexp type argu- ~ > 
ment, that argument is applied num more times. If it ae 
follows /nno , the file will be split every Inno lines 
(num times) from that point. 


Enclose all rexp type arguments that contain blanks or other char- 
acters meaningful to the Shell in the appropriate quotes. Regular 
expressions may not contain embedded new-lines. Csplit does not 
affect the original file; it is the users responsibility to remove tt. 


EXAMPLES 
csplit -f cobol file ‘’/procedure division/’ /par5./ /par16./ 


This example creates four files, cobol0O ... cobol03. After editing 
the “split” files, they can be recombined as follows: | 


cat cobol0[0—3] > file 
Note that this example overwrites the original file. 


csplit -k file 100 {99} 
This example would split the file at every 100 lines, up to 10,000 a ‘ 
lines. The —k option causes the created files to be retained if there ._” 
are less than 10,000 lines; however, an error message would still be 
printed. 


csplit -k prog.c ‘%main(%’ '/}/+1' {20} 


Assuming that prog.c follows the normal C coding convention of 
ending routines with a } at the beginning of the line, this example will 
create a file containing each separate C routine (up to 21) in prog.c 


SEE ALSO 
ed(1), sh(1). | 
regexp(5) in the SysS UNIX Programmer Reference Manual. 


DIAGNOSTICS 
Self explanatory except for: 
arg — out of range 
which means that the given argument did not reference a line 
between the current position and the end of the file. 
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_ NAME 
( “ie, ct — spawn getty to a remote terminal 


SYNOPSIS 
ct [-h ] [ -v ] [ -wn ] [ -s speed ] telno ... 


DESCRIPTION 
Ct dials the phone number of a modem that is attached to a termi- 
nal, and spawns a getty process to that terminal. Te/no is a tele- 
phone number, with equal signs for secondary dial tones and minus 
signs for delays at appropriate places. If more than one telephone 
number is specified, ct will try each in succession until one answers; 
this is useful for specifying alternate dialing paths. 


Ct will try each line listed in the file /usr/lib/uucp/L-devices until it 
finds an available line with appropriate attributes or runs out of 
entries. If there are no free lines, ct will ask if it should wait for one, 
and if so, for how many minutes it should wait before it gives up. Ct 
will continue to try to open the dialers at one-minute intervals until 
the specified limit is exceeded. The dialogue may be overridden by 
specifying the —wn option, where n is the maximum number of 
minutes that ct is to wait for a line. 


Normally, ct will hang up the current line, so that that line can 
a answer the incoming call. The —h option will prevent this action. If - 
( the —v option is used, ct will send a running narrative to the stan- 
dard error output stream. 


The data rate may be set with the —s option, where speed is 
expressed in baud. The default rate is 300. 


After the user on the destination terminal logs out, ct prompts, 
Reconnect? If the response begins with the letter n the line will be 
dropped; otherwise, getty will be started again and the login: 
prompt will be printed. 


Of course, the destination terminal must be attached to a modem 
that can answer the telephone. 


FILES 
/usr/lib/uucp/L-devices 
/usr/adm/ctlog 


SEE ALSO 
cu(1C), login(1), uucp(1C). 
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_ NAME 


} 


ctags — create a tags file 


SYNOPSIS 


/usr’plx/ctags [ —u |] [ —w ] [ -x ] name ... 


DESCRIPTION 


FILES 


NOTES 


Ctags makes a tags file for ex(1) from the specified C, Pascal and 
Fortran sources. A tags file gives the locations of specified objects 
(in this case functions) in a group of files. Each line of the tags file 
contains the function name, the file in which it is defined, and a 
scanning pattern used to find the function definition. These are given 
in separate fields on the line, separated by blanks or tabs. Using 

the tags file, ex can quickly find these function definitions. | 


If the -x flag is given, ctags produces a list of function names, the 
line number and file name on which each is defined, as well as the 
text of that line and prints this on the standard output. This is a sim- 
ple index which can be printed out as an off-line readable function 
index. 


Files whose name ends in .c or .h are assumed to be C source files 
and are searched for C routine and macro definitions. Others are 
first examined to see if they contain any Pascal or Fortran routine 
definitions; if not, they are processed again looking for C definitions. 


Other options are: 
—-w suppressing warning diagnostics. 


—u causing the specified files to be updated in tags, that is, all 
references to them are deleted, and the new values are 
appended to the file. (Beware: this option is implemented in a 
way that is rather slow; it is usually faster to simply rebuild the 
tags file.) 


The tag main is treated specially in C programs. The tag formed is 
created by prepending M to the name of the file, with a trailing .c 
removed, if any, and leading pathname components also removed. 
This makes use of ctags practical in directories with more than one 
program. 


tags output tags file 


This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
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BUGS er a 
Recognition of functions, subroutines and procedures for FOR-. 
TRAN and Pascal is done is a very simpleminded way. No attempt ~~ 
is made to deal with block structure; if you have two Pascal pro- 
cedures in different blocks with the same name, it won't work. 


The method of deciding whether to look for C or Pascal and FOR- 
TRAN functions is not very sophisticated. 
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( _ NAME 
> 


ctrace — C program debugger 


SYNOPSIS 


ctrace [ options | [ file ] 


DESCRIPTION : 
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Ctrace allows you to follow the execution of a C program, statement 
by statement. The effect is similar to executing a shell procedure 
with the -x option. Ctrace reads the C program in file (or from stan- 
dard input if you do not specify file), inserts statements to print the 
text of each executable statement and the values of all variables 
referenced or modified, and writes the modified program to the stan- 
dard output. You must put the output of ctrace into a temporary file © 
because the cc(1) command does not allow the use of a pipe. You 
then compile and execute this file. 


As each statement in the program executes it will be listed at the 
terminal, followed by the name and value of any variables refer- 
enced or modified in the statement, followed by any output from the 
statement. Loops in the trace output are detected and tracing is 
stopped until the loop is exited or a different sequence of state- 
ments within the loop is executed. A warning message is printed 
every 1000 times through the loop to help you detect infinite loops. 
The trace output goes to the standard output so you can put it into a 
file for examination with an editor or the bfs(1) or fail(1) commands. 


The only options you will commonly use are: 


-f functions — Trace only these functions. 
-v functions — Trace all but these functions. 


You may want to add to the default formats for printing variables. 
Long and pointer variables are always printed as signed integers. 
Pointers to character arrays are also printed as strings if appropri- 
ate. Char, short, and int variables are also printed as signed 
integers and, if appropriate, as characters. Double variables are 
printed as floating point numbers in scientific notation. You can 
request that variables be printed in additional formats, if appropriate, 
with these options: 


-O Octal 

—X Hexadecimal 
—u Unsigned 

—e Floating point 


These options are used only in special circumstances: 


-ln Check n consecutively executed statements for looping 
trace output, instead of the default of 20. Use 0 to get all 
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the trace output from loops. rs 

-S Suppress redundant trace output from simple assignment \ 
statements and string copy function calls. This option can — 
hide a bug caused by use of the = operator in place of the 
== operator. 

-tn Trace n variables per statement instead of the default of 10 
(the maximum number is 20). The Diagnostics section 
explains when to use this option. 


—P Run the C preprocessor on the input before tracing it. You 
can also use the -D , -l , and -U cc (7) preprocessor 
options. 


These options are used to tailor the run-time trace package when 
the traced program will run in a non-UNIX system environment: 


—b Use only basic functions in the trace code, that is, those in 
ctype (3C), printf (3S), and string (3C). These are usually 
available even in cross-compilers for microprocessors. In 
particular, this option is needed when the traced program 
runs under an operating system that does not have signal 
(2), fflush (3S), longjmp (3C), or setimp (3C). 

-—p 's’ Change the trace print function from the default of ‘printf(’. 
For example, ‘fprintf(stderr, would send the trace to the ..~ 
standard error output. 

-rf Use file f in place of the runtime.c trace function package. 
This lets you change the entire print function, instead of just 
the name and leading arguments (see the -p option). 


EXAMPLE 
If the file ic.c contains this C program: 
1 #include <stdio.h> 
2 main() /* count lines in input */ 


int c, nl; 


while ((c = getchar()) != EOF) 
if (c = ‘\n) 

++nl; 10 printf("Y%d\n", nl); 11 } and 
you enter these commands and test data: cc Ic.c a.out 1 (cntl-d), 
the program will be compiled and executed. The output of the pro- 
gram will be the number 2, which is not correct because there is 
only one line in the test data. The error in this program is common, 
but subtle. If you invoke ctrace with these commands: ctrace Ic.c - ~ 
>temp.c cc temp.c a.out the output will be: | 
2 main() ~ 


3 { 

4 

3 

6 nl = 0; 
7 

8 

9 
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( : 6 nl = 0; 
oe “nl==07*/ 


7 while ((¢ = getchar()) != EOF) The program is now waiting 
for input. If you enter the same test data as before, the output will 
be: 
*c == 49or'1'*/ 
8 if (c = ‘\n) 
/*c == 100r \n' */ 
9 + +n: 
mnal==1%/ 
7 while ((c = getchar()) |= EOF) 
/*c == 10 0r \n' */ 
8 if (c = ‘\n’) 
/*“c == 100r \n' */ 
9 + +n: 
*nl== 2%*/ 
7 while ((c = getchar()) '= EOF) If you now enter an end of 


file character (cntl-d) the final output will be: 
*c == -17°/10 printf("%d\n"", nl); 
*nl== 2 */2 return 


( | Note that the program output printed at the end of the trace line for 
er the nl variable. Also note the return comment added by ctrace at 
the end of the trace output. This shows the implicit return at the ter- 

minating brace in the function. 


The trace output shows that variable c is assigned the value ‘1’ in 
line 7, but in line 8 it has the value \n’. Once your attention is 
drawn to this if statement, you will probably realize that you used 
the assignment operator (=) in place of the equal operator (==). 
You can easily miss this error during code reading. 


EXECUTION-TIME TRACE CONTROL 
The default operation for ctrace is to trace the entire program file, 
unless you use the -f or -v options to trace specific functions. This 
does not give you statement by statement control of the tracing, nor 
does it let you turn the tracing off and on when executing the traced 
program. 


You can do both of these by adding ctroff () and ctron () function 
calls to your program to turn the tracing off and on, respectively, at 
execution time. Thus, you can code arbitrarily complex criteria for 
trace control with if statements, and you can even conditionally 
include this code because ctrace defines the CTRACE preprocessor 
variable. For example: 
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Cc Diagnostics _ 
warning: floating point not implemented — \~ 
warning: illegal combination of pointer and integer 
warning: statement not reached 
warning: sizeof returns 0 


Ignore these messages. 


compiler takes size of function 
See the ctrace "possible syntax error" message above. 


yacc stack overflow 
See the ctrace ‘if ... else if’ sequence too long” message 
above. 


out of tree space; simplify expression 
Use the -t option to reduce the number of traced variables 
per statement from the default of 10. Ignore the "ctrace: too 
many variables to trace" warnings you will now get. 


redeciaration of signal 
Either correct this declaration of signal (2), or remove it and 
#include <signal.n>. 


WARNINGS ; 
You will get a ctrace syntax error if you omit the semicolon at thc ; 
end of the last element declaration in a structure or union, just ’—~ 
before the right brace (}). This is optional in some C compilers. 


Ca 


Defining a function with the same name as a system function may 
cause a syntax error if the number of arguments is changed. Just 
use a different name. 


Ctrace assumes that BADMAG is a preprocessor macro, and that 
EOF and NULL are #defined constants. Declaring any of these to 
be variables, e.g. "int EOF;", will cause a syntax error. 


BUGS | 
Ctrace does not know about the components of aggregates like 
structures, unions, and arrays. It cannot choose a format to print all 
the components of an aggregate when an assignment is made to 
the entire aggregate. Ctrace may choose to print the address of an 
aggregate or use the wrong format (e.g., %e for a structure with two 
integer members) when printing the value of an aggregate. 


Pointer values are always treated as pointers to character strings. 


The loop trace output elimination is done separately for each file of 

a multi-file program. This can result in functions called from a loop# 
still being traced, or the elimination of trace output from one function —_/ 
in a file until another in the same file is called. 
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#ifdef CTRACE 
if (c == 'V && i > 1000) 
ctron(); 
#endif 


You can also call these functions from sdb (7) if you compile with 
the -g option. For example, to trace all but lines 7 to 10 in the main 
function, enter: 


sdb a.out 
main:7b ctroff() 
main:11b ctron() 
; 


You can also turn the trace off and on by setting static variable 
tr_ct_ to 0 and 1, respectively. This is useful if you are using a 
debugger that cannot call these functions directly, such as adb (7). 


DIAGNOSTICS 
This section contains diagnostic messages from both ctrace and cc 
(1), since the traced code often gets some cc warning messages. 
You can get cc error messages in some rare cases, all of which can 
be avoided. 


Ctrace Diagnostics 
warning: some variables are not traced in this statement 
Only 10 variables are traced in a statement to prevent the C 
compiler "out of tree space; simplify expression” error. Use 
the -t option to increase this number. 


warning: statement too long to trace 
This statement is over 400 characters long. Make sure that 
you are using tabs to indent your code, not spaces. 


cannot handle preprocessor code, use -P option : 
This is usually caused by #ifdef/#endif preprocessor state- 
ments in the middle of a C statement, or by a semicolon at 
the end of a #define preprocessor statement. 


‘if ... else if sequence too long 
Split the sequence by removing an else from the middle. 


possible syntax error, try -P option 
Use the -P option to preprocess the ctrace input, along with 
any apprepriate -D , -1, and -U preprocessor options. If you 
still get the error message, check the Warnings section 
below. 
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FILES | ._ 
runtime.c run-time trace package Me 
SEE ALSO | _ 
signal(2), ctype(3C), fflush(3S), langimp(3C), printf(3S), setimp(3C), 
string(3C) in the Sys5 UNIX Programmer Reference Manual. 


i 
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NAME 
cu — call another UNIX system 


SYNOPSIS 
cu [-sspeed] [-lIline] [-h] [-t] [-d] [-m] [-o] [-e] [-n] 
telno | systemname | dir 


DESCRIPTION 
Cu calls up another UNIX system, a terminal, or possibly a non-UNIX 
system. It manages an interactive conversation with possible 
transfers of ASCII files. 


cu accepts the following options and arguments. 


—sspeed | 
Specifies the transmission speed(110, 150, 300, 600, 1200, 
4800, 9600); 300 is the default value. Most modems are 
either 300 or 1200 baud. Directly connected lines may be 
set to a speed higher than 1200 baud. 


—lline Specifies a device name to use as the communication line. 
This can be used to override searching for the first available 
line having the right speed. When the -| option is used 
without the -s option, the speed of a line is taken from the 
file /usr/lib/uucp/L-devices. When the -| and -s options are 
used simultaneously, cu will search the L-devices file to 
check if the requested speed for the requested line is avail- 
able. If so, the connection will be made at the requested 
speed; otherwise an error message will be printed and the 
call will not be made. The specified device is generally a 
directly connected asynchronous line (e.g., /dev/ttyab), in 
this case a phone number is not required but the string dir 
may be use to specify a null acu. If the specified device is 
associated with an auto dialer, a phone number must be 
provided. 


—h Emulates local echo, supporting calls to other computer sys- 
tems which expect terminals to be set to half-duplex mode. 


—t Used when dialing an ASCII terminal which has been set to 
auto answer. Appropriate mapping of carriage-return to 
Carriage-return-line-feed pairs is set. 


-d Causes diagnostic traces to be printed. 


-e Designates that even parity is to be generated for data sent 
to the remote. 


—O Designates that odd parity is to be generated for data sent 
to the remote. 
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Designates a direct line which has modem control. 


eS 


7 


Will request the phone number to be dialed from the user 


rather than taking it from the command line. 


When using an automatic dialer the argument is the tele- 
phone number with equal signs for secondary dial tone or 
minus signs for delays, at appropriate places. 


systemname 


dir 


A uucp system name may be used rather than a phone 
number; in this case, cu will obtain an appropriate direct line 
or phone number from /usr/lib/uucp/L.sys (the appropriate 
baud rate is also read along with phone numbers). Cu will 
try each phone number or direct line for systemname in the 
L.sys file until a connection is made or all the entries are 


_ tried. 


Using dir insures that cu will use the line specified by the -| 
option. | 


After making the connection, cu runs as two processes: the 
transmit process reads data from the standard input and, except for 


lines beginning with ~ , passes it to the remote system; the receive ~~ 
process accepts data from the remote system and, except for lines | 


beginning with ~ , passes it to the standard output. Normally, an 
automatic DC3/DC1 protocol is used to control input from the remote 
so the buffer is not overrun. Lines beginning with ~ have special 
meanings. 


The transmit process interprets the following: 


terminate the conversation. 


escape to an interactive shell on the local 


system. 
“lomd... run cmd on the local system (via sh —c ). 
“$cmd... run cmd locally and send its output to the 
remote system. 
“%cd change the directory on the local system. 


NOTE: “!cd will cause the command to be 
run by a sub-shell; probably not what was 
intended. 


“%take from [ to ]_ copy file from (on the remote system) to file 
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“%put from [ to | copy file from (on local system) to file to on 
remote system. If fo is omitted, the from 
argument is used in both places. 


oe send the line ~ ... to the remote system. 
“%break transmit a BREAK to the remote system. 
“Ynostop toggles between DC3/DC1 input control proto- 


col and no input control. This is useful in 
case the remote system is one which does 
not respond properly to the DC3 and DC1 
characters. 


The receive process normally copies data from the remote system 
to its standard output. A line from the remote that begins with ~> 
initiates an output diversion to a file. The complete sequence is: 


“>[>]: file 
zero or more lines to be written to file 


- 


> 


Data from the remote is diverted (or appended, if >> is used) to file 
. The trailing “> terminates the diversion. | 


The use of “%put requires sity (71) and cat (1) on the remote side. 
It also requires that the current erase and kill characters on the 
remote system be identical to the current ones on the local system. 
Backslashes are inserted at appropriate places. 


The use of “%take requires the existence of echo (1) and cat (7) on 
the remote system. Also, stty tabs mode should be set on the 
remote system if tabs are to be copied without expansion. 


When cu is used on system X to connect to system Y and subse- 
quently used on system Y to connect to system Z, commands on 
system Y can be executed by using ~. For example, uname can be 
executed on Z, X, and Y as follows: 


uname 

Z 

tuname 

X 

~luname 

vy 

In general, ~ causes the command to be executed on the original 
machine, ~ causes the command to be executed on the next 
machine in the chain. 
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EXAMPLES —— 
To dial a system whose number is 9 201 555 1212 using 1200 “-—~ 
baud: 
cu -s1200 9=2015551212 
lf the speed is not specified, 300 is the default value. 
To login to a system connected by a direct line: 
cu -l /dev/ttyXX dir 
To dial a system with the specific line and a specific speed: 
cu -s1200 -| ‘devittyXxX dir 
To dial a system using a specific line: 
cu -| /deviculXX 2015551212 
To use a system name: 
Cu YY YZZZ 
FILES 
/usr/lib/uucp/L.sys 
/usr/lib/uucp/L-devices 
/ust/spool/uucp/LCK. .(tty-device) 
‘dev/null _ 
—_ 
SEE ALSO — 
cat(1), ct(1C), echo(1), stty(1), uname(1), uucp(1C). a 
DIAGNOSTICS 
Exit code is zero for normal exit, non-zero (various values) other- 
wise. 
BUGS 


Cu buffers input internally. 
There is an artificial slowing of transmission by cu during the “%put 
operation so that loss of data is unlikely. 
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cut — cut out selected fields of each line of a file 


SYNOPSIS 


cut —Cclist [file1 file2 ...] 
cut -flist [-dchar] [-s] [file1 file2 ...] 


DESCRIPTION 


HINTS 
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Use cut to cut out columns from a table or fields from each line of a 
file; in data base parlance, it implements the projection of a relation. 
The fields as specified by list can be fixed length, i.e., character 
positions as on a punched card (—c option) or the length can vary — 
from line to line and be marked with a field delimiter character like 
tab (-f option). Cut can be used as a filter; if no files are given, the 
standard input is used. 


The meanings of the options are: 


list A comma-separated list of integer field numbers (in 
increasing order), with optional — to indicate ranges as in 
the -o option of nroff / troff for page ranges; e.g., 1,4,7 ; 
1-3,8 ; -5,10 (short for 1-5,10); or 3-— (short for third 
through last field). 


-Clist The list following ~c¢ (no space) specifies character posi- 
tions (e.g., -c1-72 would pass the first 72 characters of 
each line). 


-tist The list following -f is a list of fields assumed to be 
separated in the file by a delimiter character (see —d ); e.g., 
-f1,7 copies the first and seventh field only. Lines with no 
field delimiters will be passed through intact (useful for 
table subheadings), unless —s is specified. 


—dchar The character following -d is the field delimiter (-f option 
only). Default is tab . Space or other characters with spe- 
cial meaning to the shell must be quoted. | 


—S Suppresses lines with no delimiter characters in case of —f 
option. Unless specified, lines with no delimiters will be 
passed through untouched. 


Either the —c or -f option must be specified. 


Use grep (1) to make horizontal “cuts” (by context) through a file, 
or paste (1) to put files together column-wise (i.e., horizontally). To 
reorder columns in a table, use cut and paste . 
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EXAMPLES -_ 
cut —d: -f1,5 /etc/passwd mapping of userIDs tonames “~~ 
name=*who am i|cut-f1-d""* to set name to current login 

name. 

DIAGNOSTICS 
line too long A line can have no more than 1023 characters 

or fields. 
bad list forc/foption 
| Missing —c or —f option or incorrectly specified 
list . No error occurs if a line has fewer fields 
than the /ist calls for. 
no fields The list is empty. 

SEE ALSO 

grep(1), paste(1). 
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NAME 


cxref — generate C program cross-reference 


SYNOPSIS 
cxref [ options | files 


DESCRIPTION | 
Cxref analyzes a collection of C files and attempts to build a cross- 
reference table. Cxref utilizes a special version of cpp to include 
#define ‘d information in its symbol table. It produces a listing on 
standard output of all symbols (auto, static, and global) in each file 
separately, or with the —c option, in combination. Each symbol con- 
tains an asterisk (*) before the declaring reference. 


In addition to the —D , ~f and —U options (which are identical to their 
interpretation by cc (7)), the following options are interpreted by 


cxref : 
—C Print a combined cross-reference of all input files. 
—w<num> 


Width option which formats output no wider than <num=> 
(decimal) columns. This option will default to 80 if <num> 
is not specified or is less than 51. 


-O file Direct output to named file. 


-s Operate silently; does not print input file names. 
—t Format listing for 80-column width. 
FILES 
-usrilib/xcpp special version of C-preprocessor. 
SEE ALSO 
cc(1). 
DIAGNOSTICS 


Error messages are unusually cryptic, but usually mean that you 
cannot compile these files, anyway. 


BUGS 
Cxref considers a formal argument in a #define macro definition to 
be a declaration of that symbol. For example, a program that 
#include s ctype.h , will contain many declarations of the variable c 
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NAME | 
date — print and set the date ee 
SYNOPSIS 
date [ mmddhhmmyy] ] [ +format ] 
DESCRIPTION 


If no argument is given, or if the argument begins with +, the 
current date and time are printed. Otherwise, the current date is 
set. The first mm is the month number; dd is the day number in the 
month; hh is the hour number (24 hour system); the second mm is 
the minute number; yy is the last 2 digits of the year number and Is 
optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if 
no year is mentioned. The system operates in GMT. Date takes 
care of the conversion to and from local standard and daylight time. 


If the argument begins with +, the output of date is under the con- 

trol of the user. The format for the output is similar to that of the 

first argument to printf (3S). All output fields are of fixed size (zero 
padded if necessary). Each field descriptor is preceded by % and ~~ 
will be replaced in the output by its corresponding value. A single % 
is encoded by %%. All other characters are copied to the output 
without change. The string is always terminated with a new-line 
character. 


Field Descriptors: 
insert a new-line character 
insert a tab character 
~ month of year — 01 to 12 
day of month — 01 to 31 
last 2 digits of year — 00 to 99 
date as mm/dd/yy 
hour — 00 to 23 
minute — 00 to 59 
second — 00 to 59 
time as HH:MM:SS 
day of year — 001 to 366 
day of week — Sunday = 0 
abbreviated weekday — Sun to Sat 
abbreviated month — Jan to Dec 
time in AM/PM notation — 


“yo s™HHEBZ2TO< A575 
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_, EXAMPLE 


date '+DATE: %M/ %d/%y%n TIME: %H:%M:%S' 
would have generated as output: 
DATE: 08/01, 76 


TIME: 14:45:05 

DIAGNOSTICS 

No permission if you are not the super-user and you try to 

change the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character if the field descriptor is not recognizable. 
FILES 

idev/kmem 
SEE ALSO 


printf(3S) in the Sys5 UNIX Programmer Reference Manual. 
WARNING 

It is a bad practice to change the date while the system ts running 

multi-user, 7 
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dc — desk calculator 


SYNOPSIS 


de [ file ] 


DESCRIPTION 
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De is an arbitrary precision arithmetic package. Ordinarily it 
operates on decimal integers, but one may specify an input base, 
output base, and a number of fractional digits to be maintained. 
(See bc(1), a preprocessor for dc that provides infix notation and a 
C-like syntax that implements functions. Bc also provides reason- 
able control structures for programs.) The overall structure of dc is 
a stacking (reverse Polish) calculator. If an argument is given, input 
is taken from that file until its end, then from the standard input. 
The following constructions are recognized: 


number 
The value of the number is pushed on the stack. A number 
is an unbroken string of the digits O-9. It may be preceded 
by an underscore (_) to input a negative number. Numbers 
may contain decimal points. 


+ —-/* %* 
The top two values on the stack are added (+), subtracted 
(—), multiplied (*), divided (/), remaindered (%), or exponen- 
tiated (“). The two entries are popped off the stack; the result 
is pushed on the stack in their place. Any fractional part of 
an exponent is ignored. | 


sx The top of the stack is popped and stored into a register 
named x , where x may be any character. If the $s is capital- 
ized, x is treated as a stack and the value is pushed on it. 


Ix The value in register x is pushed on the stack. The register 
x is not altered. All registers start with zero value. If the [is 
capitalized, register x is treated as a stack and its top value 
is popped onto the main stack. 


The top value on the stack is duplicated. 


The top value on the stack is printed. The top value remains 
unchanged. P interprets the top of the stack as an ASCII 
string, removes it, and prints it. 


f All values on the stack are printed. 
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exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack 
is popped and the string execution level is popped by that 
value. 


treats the top element of the stack as a character string and 
executes it as a string of dc commands. 


replaces the number on the top of the stack with its scale fac- 
tor. 


puts the bracketed ASCII string onto the top of the stack. 


<X >X =X 
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The top two elements of the stack are popped and compared. 
Register x is evaluated if they obey the stated relation. 


replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 


interprets the rest of the line as a UNIX system command. 
All values on the stack are popped. 


The top value on the stack is popped and used as the 
number radix for further input. | pushes the input base on the 
top of the stack. 


The top value on the stack is popped and used as the 
number radix for further output. 


pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is used as a 
non-negative scale factor: the appropriate number of places 
are printed on output, and maintained during multiplication, 
division, and exponentiation. The interaction of scale factor, 
input base, and output base will be reasonable if all are 
changed together. 


The stack level is pushed onto the stack. 
replaces the number on the top of the stack with its length. 


A line of input is taken from the input source (usually the ter- 
minal) and executed. 


are used by bc for array operations. 
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EXAMPLE -. 
This example prints the first ten values of n!: ae 4 
[lai+dsa*pla10>y]sy 
Osal 
lyx 
SEE ALSO 
bce(1). 
DIAGNOSTICS 


x is unimplemented 
where x is an octal number. 


stack empty 
for not enough elements on the stack to do what was 
asked. 


Out of space 
when the free list is exhausted (too many digits). 


Out of headers 
for too many numbers being kept around. 


Out of pushdown ua 
for too many items on the stack. ! , 
Nesting Depth _ 
for too many levels of nested execution. 
—_ 
= 
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dd — convert and copy a file 


SYNOPSIS 


dd [option:- value] ... 


DESCRIPTION | 
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Dd copies the specified input file to the specified output with possi- 
ble conversions. The standard input and output are used by default. 
The input and output block size may be specified to take advantage 
of raw physical |.O. 


option values 

if -- file input file name; standard input is default 

of - file output file name; standard output is default 

ibsn input block size n bytes (default 1024) 

obs --/n output block size (default 1024) 

bs=n set both input and output block size, superseding 


ibs and obs ; also, if no conversion is specified, it is 
particularly efficient since no in-core copy need be 


done 

cos=n conversion buffer size 

skip =n skip n input blocks before starting copy 

seek =7 seek n blocks from beginning of output file before 
copying 

count=n copy only n input blocks 


conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCIi to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 
Ilcase map alphabetics to lower case 

ucase map alphabetics to upper case 

swab swap every pair of bytes 
-noerror do not stop processing on an =rror 
sync pad every input block to ‘bs 

flip invert bits for P.35 compatibility. 

.2+,+.. SEVEeral Comma-Separated Conversions 


Where sizes are specified, a number of bytes is expected. A 
number may end with k , b , or wto specify multiplication by 1024, 
512, or 2, respectively; a pair of numbers may be separated by x to 
indicate a product. 


Cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, 
converted to ASCII, and trailing blanks trimmed and new-line added 
before sending the line to the output. In the latter case ASCII char- 
acters are read into the conversion buffer, converted to EBCDIC, and 
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\ 
After compietion, dd reports the number of whole and partial input = 
and output blocks. 


FXAMPLE 
This command will read an EBCDIC tape blocked ten 80-byte 
EBCDIC card images per block into the ASCll file x : 


dd if= dev'rmt'OQm of: x ibs. 800 cbs--80 conv -ascii,lcase 


blanks added to make up an output block of size cbs . 


Note the use of raw magtape. Dd is especially suited to |'O on the 
raw physical devices because it allows reading and writing in arbi- 
trary block.sizes. 


SEE ALSO 
cp(1). 
DIAGNOSTICS 


f+p blocks in(out) numbers of full and partial blocks 
read(written) 


NOTES 
Plexus provides a standalone version of dd in addition to the one 
that runs under Sys5. | we 


BUGS 
The ASCIVEBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The ibm conversion, 
while less blessed as a standard, corresponds better to certain IBM 
print train conventions. There is no universal solution. 


New-lines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. These should be separate options. 
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NAME 


delta — make a delta (change) to an SCCS file 

SYNOPSIS 
delta [-rSID] [-s] [-n] [-glist] [—m[mrlist]] [-y[comment]] [—p] 
files 

DESCRIPTION 
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Delta is used to permanently introduce into the named SCCS file 
changes that were made to the file retrieved by get (7) (called the 
g-file , or generated file). 


Delta makes a delta to each named SCCS file. If a directory is 
named, de/fa behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last com- 
ponent of the path name does not begin with s.) and unreadable 
files are silently ignored. If a name of — is given, the standard input 
is read (see WARNINGS); each line of the standard input is taken to 
be the name of an SCCS file to be processed. 


Delta may issue prompts on the standard output depending upon 
certain keyletters specified and flags (see admin (1)) that may be 
present in the SCCS file (see -m and —-y keyletters below). 


Keyletter arguments apply independently to each named file. 


-rS/D Uniquely identifies which delta is to be made 
to the SCCS file. The use of this keyletter is 
necessary only if two or more outstanding get 
S for editing (get -e) on the same SCCS file 
were done by the same person (login name). 
The SID value specified with the -r keyletter 
can be either the SID specified on the get 
command line or the SID to be made as 
reported by the get command (see get (7)). 
A diagnostic results if the specified SID is 
ambiguous, or, if necessary and omitted on 
the command line. 


-S Suppresses the issue, on the standard out- 
put, of the created delta’s SID, as well as the 
number of lines inserted, deleted and 
unchanged in the SCCS file. 


—n Specifies retention of the edited g-file (nor- 
mally removed at completion of delta pro- 
cessing). 

—glist Specifies a fist (see get (1) for the definition 


of fist) of deltas which are to be ignored when 
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—y[(comment] 
—p 

FILES 


All files of the form ?- file are explained in the Source Code Control | 
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the file is accessed at the change level (SID) 
created by this delta. 


If the SCCS file has the v flag set (see admin 
(1)) then a Modification Request (MR) 
number must be supplied as the reason for 
creating the new delta. 


lf -m is not used and the standard input is a 
terminal, the prompt MRS? is issued on the 
standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRs? prompt 
always precedes the comments? prompt 
(see —y keyletter). — 


MRs in a list are separated by blanks andror 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 


Note that if the v flag has a value (see admin 
(7)), it is taken to be the name of a program 
(or shell procedure) which will validate the 


correctness of the MR numbers. If a non- | 
zero exit status is returned from MR number — 


validation program, delta terminates (it is 
assumed that the MR numbers were not all 
valid). 


Arbitrary text used to describe the reason for 
making the delta. A null string is considered 
a valid comment. 


If -y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 


Causes delta to print (on the standard output) 
the SCCS file differences before and after the 
delta is applied in a off (7) format. 


System User Guide. The naming convention for these files is also 


described there. 
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g-file Existed before the execution of delta ; removed after 
completion of delta . 

p-file Existed before the execution of delta ; may exist after 

| completion of delta . 

q-file Created during the execution of delta ; removed after 
completion of delta , 

x-file Created during the execution of delta ; renamed to 
SCCS file after completion of delta . 

z-file Created during the execution of deffa ; removed dur- 
ing the execution of delta . 

d-file Created during the execution of delta ; removed after 


completion of delta . 
/usr/bin/bdiff Program to compute differences between the “gotten” 
file and the g-file . 


WARNINGS 


Lines beginning with an SOH ASCII character (binary 001) cannot be 
placed in the SCCS file unless the SOH is escaped. This character 
has special meaning to SCCS (see sccsfile(4) (5)) and will cause an 
error. 


A get of many SCCS files, followed by a delta of those files, should 
be avoided when the get generates a large amount of data. 
Instead, multiple get/delta sequences should be used. 


If the standard input (—) is specified on the delta command line, the 
—m (if necessary) and -y keyletters must also be present. Omis- 
sion of these keyletters causes an error to occur. 


Comments are limited to text strings of at most 512 characters. 


SEE ALSO 


admin(1), odiff(1), cdce(1), get(1), help(1), prs(1), rmdel(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
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Use help (1) for explanations. 
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NAME | 
deroff — remove nroff/troff, tol, and eqn constructs 
SYNOPSIS 
deroff [ —w ] [ —mx ] [ files ] 
DESCRIPTION 


Deroff reads each of the files in sequence and removes all troff(1) 
requests, macro calls, backslash constructs, eqn(1) constructs 
(between .EQ and .EN lines, and between delimiters), and ftb/(1) 
descriptions, and writes the remainder of the file on the standard 
output. Deroff follows chains of included files (.so and .nx troff 
commands); if a file has already been included, a .so naming that 
file is ignored and a .nx naming that file terminates execution. If no 
input file is given, deroff reads the standard input. 


The —m option may be followed by an m, s, or I. The resulting 
—mm or —ms option causes the mm or ms macros to be interpreted 
so that only running text is output (i.e., no text from macro lines.) 
The —ml option forces the -mm option and also causes deletion of 
lists associated with the mm macros. 


If the —w option is given, the output is a word list, one “word” per 
line, with all other characters deleted. Otherwise, the output follows 


the original, with the deletions mentioned above. In text, a “word” is © 


any string that contains at least two letters and is composed of 
letters, digits, ampersands (&), and apostrophes (’); in a macro call, 
however, a “word” is a string that begins with at least two letters 
and contains a total of at least three letters. Delimiters are any 
characters other than letters, digits, apostrophes, and ampersands. 
Trailing apostrophes and ampersands are removed from “words.” 


SEE ALSO 


BUGS 
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eqn(1), tol(1), troff(1). 


Deroff is not a complete troff interpreter, so it can be confused by 
subtle constructs. In particular, the output of .tl requests is a bit 
bizarre. Most such errors result in too much rather than too little 
output. 

The —mil option does not handle nested lists correctly. 
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NAME 
dial — dial a Racal-Vadic 3451 modem 
mdial — dial the P/75 onboard modem. 


SYNOPSIS 
dial devname speed phone# 
mdial devname speed phone# 


DESCRIPTION 
These programs dial two specific types of modems. dial works with 
a Racal-Vadic 3451 modem. mdial works with a P/75’s onboard 
CH1770 modem. 


The first parameter is the name of the device used to access the 
modems, for example, ttyO or modem. The second parameter is © 
the speed to use, 300 or 1200 baud, and the third parameter is the 
phone number that is fed to the modem. 


The programs will provide various exit codes depending on what 

happened: 
exit(0) - Connection was made. 
exit(1) - Parameter error. 

exit(2) - Can't use dialer tty in some way. 

exit(3) - Dialer indicated no answer. 

exit(4) - Dialer not responding. 
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( NAME 
f. 7 diff — differential file comparator 
SYNOPSIS 


diff { -efbh | filet file2 


DESCRIPTION | 


FILES 


Diff tells what lines must be changed in two files to bring them into 
agreement. lf file? (file2) is — , the standard input is used. If file? 
(file2) is a directory, then a file in that directory with the name file2 
(file1) is used. The normal output contains lines of these forms: 


nt an3,n4 
ni,n2dan3 
ni,n2 ¢n3,n4 


These lines resemble ed commands to convert file? into file2 . The 
numbers after the letters pertain to file2 . In fact, by exchanging a 
for d and reading backward one may ascertain equally how to con- 
vert file2 into file1 . As in ed , identical pairs, where n7? = n2 or n3 
= n4, are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in 
the first file flagged by <, then all the lines that are affected in the 
second file flagged by >. 


The —b option causes trailing blanks (spaces and tabs) to be 
ignored and other strings of blanks to compare equal. 


The —e option produces a script of a, c , and d commands for the 
editor ed , which will recreate file2 from file? . The —f option pro- 
duces a similar script, not useful with ed , in the opposite order. In 
connection with -e , the following shell program may help maintain 
multiple versions of a file. Only an ancestral file ($1) and a chain of 
version-to-version ed scripts ($2,$3,...) made by diff need be on 
hand. A ‘latest version” appears on the standard output. 


(shift; cat $*; echo '1,$p’) | ed — $1 


Except in rare circumstances, diff finds a smallest sufficient set of 
file differences. 


Option —h does a fast, half-hearted job. It works only when 
changed stretches are short and well separated, but does work on 
files of unlimited length. Options —e and -f are unavailable with —-h . 


/usr/lib/diffh for —h 


SEE ALSO 
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cmp(1), comm(1), ed(1). 
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ff ° 


DIAGNOSTICS 4 
Exit status is 0 for no differences, 1 for some differences, 2 for trou-‘—_~ 
ble. 


BUGS 
Editing scripts produced under the ~—e or -f option are naive 
about creating lines consisting of a single period (.). 


WARNINGS 
Missing newline at end of file X 
indicates that the last line of file X did not have a new-line. If 
the lines are different, they will be flagged and output; 
although the output will seem to indicate they are the same. 
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NAME 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diff3 [ -ex3 ] file1 file2 file3 


DESCRIPTION 7 


FILES 


Diff3 compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 


Ss = all three files differ 


a file! is different 
=a==9 file2 is different 
====3 file3 is different 


The type of change suffered in converting a given range of a given 
file to some other is indicated in one of these ways: 


f:inla Text is to be appended after line number 
n? infile f, where f = 1, 2, or 3. 


fint,n2c Text is to be changed in the range line n7 
to line n2. If n? = n 2, the range may be 
abbreviated to n7. 


The original contents of the range follows immediately after a ¢ indi- 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 


Under the -—e option, diff3 publishes a script for the editor ed that 
will incorporate into file? all changes between file2 and file3 , i.e., 


the changes that normally would be flagged ==== and ====3. 
Option -x (-3) produces a script to incorporate only changes 
flagged ==== (====3). The following command will apply the 


resulting script to file? . 
(cat script; echo '1,$p’) | ed — filet 


itmpid3* 
/usrilibsdiff8prog 


SEE ALSO 


BUGS 
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diff(1). 


Text lines that consist of a single . will defeat ~e . 
Files longer than 64K bytes will not work. 
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NAME ; | 
diffmk — mark differences between files ey 
SYNOPSIS 
diffmk name1 name2 name3 
DESCRIPTION 


Diffmk compares two versions of a file and creates a third file that 
includes “change mark’ commands for nroff or troff (1). Name? and 
name2 are the old and new versions of the file. Diffmk generates 
name3 , which contains the lines of name2 plus inserted formatter 
“change mark” (.mc) requests. When name3 is formatted, changed 
or inserted text is shown by | at the right margin of each line. The 
position of deleted text is shown by a single * . 


If anyone is so inclined, diffmk can be used to produce listings of C 
(or other) programs with changes marked. A typical command line 
for such use is: 


diffmk old.c new.c tmp; nroff macs tmp | pr 
where the file macs contains: 


pl 1 

Al 77 eos 
nf aa 
.e0 oe 
ne * 


The .Il request might specify a different line length, depending on 
the nature of the program being printed. The .eo and .nc requests 
are probably needed only for C programs. 


lf the characters | and * are inappropriate, a copy of diffmk can be 
edited to change them (diffmk is a shell procedure). 


SEE ALSO 
diff(1), nroff(1), troff(1). 


BUGS 
Aesthetic considerations may dictate manual adjustment of some 
output. File differences involving only formatting requests may pro- 
duce undesirable output, i.e., replacing .sp by .sp 2 will produce a 
“change mark” on the preceding or following line of output. 
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NAME 

dircmp — directory comparison 
SYNOPSIS 

dircmp [ -d | [ -s ] [ -wn ] dir1 dir2 
DESCRIPTION | 


Dircmp examines dir? and dir2 and generates various tabulated 
information about the contents of the directories. Listings of files that 
are unique to each directory are generated for all the options. If no 
option is entered, a list is output indicating whether the filenames 
common to both directories have the same contents. 


—d Compare the contents of files with the same name in both 
directories and output a list telling what must be changed in 
the two files to bring them into agreement. The list format is 
described in diff (7). 


-S Suppress messages about identical files. 


-wn Change the width of the output line to n characters. The 
default width is 72. 


SEE ALSO 
| cmp(1), diff(1). 
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NAME _-_ 
du — summarize disk usage | ee 
SYNOPSIS 
du [ -ars ] [ names ] 
DESCRIPTION 


Du gives the number of blocks contained in ail files and (recursively) 
directories within each directory and file specified by the names 
argument.. The block count includes the indirect blocks of the file. If 
names is missing, . is used. Blocks are 1024 bytes long. 


The optional argument —s causes only the grand total (for each of 
the specified names ) to be given. The optional argument —a 
causes an entry to be generated for each file. Absence of either 
Causes an entry to be generated for each directory only. 


Du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The -r option will cause du to generate 
messages in such instances. 


A file with two or more links is counted only once. 


NOTES 
Plexus provides a standalone version of du in addition to the one~ 
that runs under Sys5. —— 


BUGS 
If the —a option is not used, non-directories given as arguments are 
not listed. 
If there are too many distinct linked files, du will count the excess 
files more than once. 
Files with holes in them will get an incorrect block count. 


Sed, 
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_ NAME 
( } dump — dump selected parts of an object file 


SYNOPSIS 


/bin/dump [—acfghlorst] [-z name] files 


DESCRIPTION 


Paae 1 


The dump command dumps selected parts of each of its object file 
arguments. 


This command will accept both object files and archives of object 
files. It processes each file argument according to one or more of 
the following options: 


—a Dump the archive header of each member of each 
archive file argument. 

—g Dump the global symbols in the symbol table of an 
archive. 

—f Dump each file header. 

—-O Dump each optional header. 

—h Dump section headers. 

-Ss Dump section contents. 

—r Dump relocation information. 


—| Dump line number information. 

—t Dump symbol table entries. 

-z name Dump line number entries for the named function. 
—C Dump the string table. 


The following modifiers are used in conjunction with the options 
listed above to modify their capabilities. 


~d number Dump the section number or range of sections starting 
at number and ending either at the last section number 
or number specified by +d. 


+d number 
Dump sections in the range either beginning with first 
section or beginning with section specified by —d. 


—n name Dump information pertaining only to the named entity. 
This modifier applies to -h , -s ,-r, -I, and -t. 


—p Supress printing of the headers. 


-t index Dump only the indexed symbol table entry. The -t 
used in conjunction with +t , specifies a range of sym- 
bol table entries. 
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+t index Dump the symbol table entries in the range ending with ~ 
the indexed entry. The range begins at the first symbok, 
table entry or at the entry specified by the —t option. 


—u Underline the name of the file for emphasis. | 


—-V Dump information in symbolic representation rather 
than numeric (e.g., C_STATIC instead of 0X02 ). This 
modifier can be used with all the above options except 
-s and —o options of dump. 


-Z name,number 
Dump line number entry or range of line numbers start- 
ing at number for the named function. 


+z number 
Dump line numbers starting at either function name or 
number specified by -—z, up to number specified by +z 


Blanks separating an option and its modifier are optional. The 
comma separating the name from the number modifying the —z 
option may be replaced by a blank. 


The dump command attempts to format the information it dumps in .— 
a meaningful way, printing certain information in character, hex, 


octal or decimal representation as appropriate. Sa 
SEE ALSO 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 
(— % 
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NAME 


dx9700 — prepare troff documents for the Xerox 9700 printer 


SYNOPSIS 


dx9700 name 


DESCRIPTION 


The dx9700 filter is a post-processor for device independent troff 
output, and produces codes suitable for being sent to a Xerox 9700 
laser printer. 


The single argument to dx9700 should be the name part of the 
—Tname argument given to troff. 


The output of the dx9700 filter should be directed to the input of a 
Xerox 9700 printer. 


Note that the Xerox 9700 treats different point sizes as different 
fonts. Hence, the font tables specified to troff(1) and dx9700 actu- 
ally specify a family of typefaces and point sizes. The font families 
that are supported for the Xerox 9700 and that can be specified to 
troff using the -T option follow: 


name contains 


X97.tim10p Times, 7, 10, and 15 point 
X97.tim12p Times, 9, 12, and 17 point 


SEE ALSO 


BUGS 
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troff(1), troff(5). 


Special fonts for the Xerox 9700 printer are needed to use with this 
post-processor. 
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( NAME 
_, echo — echo arguments 


SYNOPSIS 
echo [ arg ] ... 


DESCRIPTION 
Echo writes its arguments eepniaied by blanks and terminated by a 
new-line on the standard output. It also understands C-like escape 
conventions; beware of conflicts with the shell’s use of \: 


\b backspace 
\c print line without new-line 
\f form-feed 
\n new-line 
\r Carriage return 
\t tab 
\v vertical tab 
\\ backslash 
Ve the 8-bit character whose ASCII code Is the 1-, 2- or 
_ 3-digit octal number n , which must start with a 
zero. 
( = Echo is useful for producing diagnostics in command files and for 
ni sending known data into a pipe. 
SEE ALSO 
sh(1). 
WARNING 


Csh has an established echo command that only recognizes some 
of the escape sequences. See csh in Sys5 UNIX User Guide. lf 
you desire one of the missing sequences, use the full pathname 
/bin/echo. 
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ed, red — text editor 


_ SYNOPSIS 


ed [ — ] [ -p string ] [ -x ] [ file ] 
red [ — ] [ -p string ] [ -x ] [ file ] 


DESCRIPTION 
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Ed is the standard text editor. If the file argument is given, ed 
simulates an e command (see below) on the named file; that is to 
say, the file is read into ed ‘s buffer so that it can be edited. The 
optional — suppresses the printing of character counts by e, r, and 
w commands, of diagnostics from e and g commands, and of the ! 
prompt after a !shell command. The —p option allows the user to 
specify a prompt string. If —x is present, an x command is simu- 
lated first to handle an encrypted file. Ed operates on a copy of the 
file it is editing; changes made to the copy have no effect on the file 
until a w (write) command is given. The copy of the text being 
edited resides in a temporary file called the buffer . There is only 
one buffer. 


Red is a restricted version of ed . It will only allow editing of files in 


—_ 


ae i 


the current directory. It prohibits executing shell commands via ~ 


Ishell command. Attempts to bypass these restrictions result in an 
error message (restricted shell). 


Both ed and red support the fspec (4) formatting capability. After 
including a format specification as the first line of file and invoking 
ed with your terminal in stty -tabs or stty tab3 mode (see stty (7), 
the specified tab stops will automatically be used when scanning file 
. For example, if the first line of a file contained: 
<:t5,10,15 s72:> | 

tab stops would be set at columns 5, 10, and 15, and a maximum 
line length of 72 would be imposed. NOTE: while inputting text, tab 
characters when typed are expanded to every eighth column as is 
the default. 


Commands to ed have a simple and regular structure: zero, one, or 
two addresses followed by a single-character command , possibly 
followed by parameters to that command. These addresses specify 
one or more lines in the buffer. Every command that requires 
addresses has default addresses, so that the addresses can very 
often be omitted. 


In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in 
input mode. In this mode, no commands are recognized; all input is 
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merely collected. Input mode is left by typing a period (.) alone at 
the beginning of a line. 


Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some 
commands (e.g., s ) to specify portions of a line that are to be sub- 
stituted. A regular expression (RE) specifies a set of character 
strings. A member of this set of strings is said to be matched by 
the RE. The REs allowed by ed are constructed as follows: 


The following one-character RE s match a single character: 


1.1 


1.2 


1.3 


1.4 


An ordinary character (not one of those discussed in 1.2 
below) is a one-character RE that matches itself. 


A backslash (\) followed by any special character is a one- 
character RE that matches the special character itself. The 
special characters are: 


a. ., *, [, and \ (period, asterisk, left square bracket, and 
backslash, respectively), which are always special, 
except when they appear within square brackets ([]; see 
1.4 below). 


b. ~* (caret or circumflex), which is special at the beginning 
of an entire RE (see 3.1 and 3.2 below), or when it 
immediately follows the left of a pair of square brackets 
([]) (see 1.4 below). 


c. $ (currency symbol), which is special at the end of an 
entire RE (see 3.2 below). 


d. The character used to bound (i.e., delimit) an entire RE, 
which is special for that RE (for example, see how slash 
(/) is used in the g command, below.) 


A period (.) is a one-character RE that matches any character 
except new-line. 


A non-empty string of characters enclosed in square brackets 
({]) is a one-character RE that matches any one character in 
that string. If, however, the first character of the string is a cir- 
cumflex (*), the one-character RE matches any character 
except new-line and the remaining characters in the string. 
The * has this special meaning only if it occurs first in the 
string. The minus (—) may be used to indicate a range of con- 
secutive ASCII characters; for example, [0-9] is equivalent to 
[0123456789]. The — loses this special meaning if it occurs 
first (after an initial *, if any) or last in the string. The right 
square bracket (]) does not terminate such a string when it is 
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the first character within it (after an initial *, if any); e.g., [Ja-f] “ > 
matches either a right square bracket (]) or one of the letters &___/ 
a through f inclusive. The four characters listed in 1.2.a 
above stand for themselves within such a string of characters. 


The following rules may be used to construct RE s from one- 
character REs: | 


2.1 


2.2 


2.3 


2.4 


2.5 


2.6 


A one-character RE is a RE that matches whatever the one- 
character RE matches. 


A one-character RE followed by an asterisk (*) is a RE that 
matches zero or more occurrences of the one-character RE. 
If there is any choice, the longest leftmost string that permits a 
match is chosen. | 


A one-character RE followed by \{m\}, \m,\}, or m,n\} is a 
RE that matches a range of occurrences of the one-character 
RE. The values of m and n must be non-negative integers 
less than 256; \m\} matches exactly m occurrences; \{m,\} 
matches at feast m occurrences; \{m,n\} matches any 
number of occurrences between m and inclusive. When- 
ever a choice exists, the RE matches as many occurrences as 
possible. 


The concatenation of REs is a RE that matches the concatena- ~~ — 
tion of the strings matched by each component of the RE. 


A RE enclosed between the character sequences \( and \) is a 
RE that matches whatever the unadorned RE matches. 


The expression \n matches the same string of characters as 
was matched by an expression enclosed between \{ and \) 
earlier in the same RE. Here rn is a digit; the sub-expression 
specified is that beginning with the n -th occurrence of \( 
counting from the left. For example, the expression *\(.*\)\1$ 
matches a line consisting of two repeated appearances of the 
same string. 


Finally, an entire RE may be constrained to match only an initial 
segment or final segment of a line (or both). 


3.1 


A circumflex (*) at the beginning of an entire RE constrains 
that RE to match an initial segment of a line. 


3.2 A currency symbol ($) at the end of an entire RE constrains 


The construction *entire RE$ constrains the entire RE to match the ( 


that RE to match a final segment of a line. 


entire line. Nee 2 
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The null RE (e.g., //) is equivalent to the last RE encountered. See 
also the last paragraph before FILES below. 


To understand addressing in ed it is necessary to know that at any 
time there is a current line . Generally speaking, the current line is 
the last line affected by a command; the exact effect on the current 


line 


is discussed under the description of each command. 


Addresses are constructed as follows: 


1. 


2 
3. 
4 
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The character . addresses the current line. 
The character $ addresses the last line of the buffer. 
A decimal number n addresses the n -fth line of the buffer. 


‘x addresses the line marked with the mark name character x 
, which must be a lower-case letter. Lines are marked with 
the k command described below. 


A RE enclosed by slashes (/) addresses the first line found by 
searching forward from the line following the current line 
toward the end of the buffer and stopping at the first line con- 
taining a string matching the RE. If necessary, the search 
wraps around to the beginning of the buffer and continues up 
to and including the current line, so that the entire buffer is 
searched. See also the last paragraph before FILES below. 


A RE enclosed in question marks (?) addresses the first line 
found by searching backward from the line preceding the 
current line toward the beginning of the buffer and stopping at 
the first line containing a string matching the RE. If necessary, 
the search wraps around to the end of the buffer and contin- 
ues up to and including the current line. See also the last 
paragraph before FILES below. 


An address followed by a plus sign (+) or a minus sign (-) 
followed by a decimal number specifies that address plus 
(respectively minus) the indicated number of lines. The plus 
sign may be omitted. 


lf an address begins with + or -, the addition or subtraction is 
taken with respect to the current line; e.g, -5 is understood to 
mean .—5. 
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If an address ends with + or -, then 1 is added to or sub- -_ 
tracted from the address, respectively. As a consequence of \__” 


this rule and of rule 8 immediately above, the address —- refers 
to the line preceding the current line. (To maintain compatibil- 
ity with earlier versions of the editor, the character * in 
addresses is entirely equivalent to —.) Moreover, trailing + and 
-— characters have a cumulative effect, so — refers to the 
current line less 2. 


10. For convenience, a comma (,) stands for the address pair 1,$, 
while a semicolon (;) stands for the pair .,$. 


Commands may require zero, one, or two addresses. Commands 
that require no addresses regard the presence of an address as an 
error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if 
more addresses are given than such a command requires, the last 


— one(s) are used. 
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Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, 
the current line (.) is set to the first address, and only then is the 


second address calculated. This feature can be used to determine | 
the starting line for forward and backward searches (see rules 5. . 


and 6. above). The second address of any two-address sequence 
must correspond to a line that follows, in the buffer, the line 
corresponding to the first address. 


In the following list of ed commands, the default addresses are 
shown in parentheses. The parentheses are not part of the 
address; they show that the given addresses are the default. 


It is generally illegal for more than one command to appear on a 
line. However, any command (excepte,f,r, or w ) may be suf- 


fixed by I, n, or p in which case the current line is either listed, num- 


bered or printed, respectively, as discussed below under the/,n, 
and p commands. 


(.)a 


<text> 


The a ppend command reads the given text and appends it 
after the addressed line; . is left at the last inserted line, or, 
if there were none, at the addressed line. Address 0 ts legal 
for this command: it causes the ‘appended’ text to be 


placed at the beginning of the buffer. The maximum , 
number of characters that may be entered from a terminal is - 


256 per line (including the new-line character). 
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<text> 


e file 


E file 


f file 


UNIX Sys5 ED(1) 


The c hange command deletes the addressed lines, then 
accepts input text that replaces these lines; . is left at the 
last line input, or, if there were none, at the first line that 
was not deleted. 


The d elete command deletes the addressed lines from the 
buffer. The line after the last line deleted becomes the 
current line; if the lines deleted were originally at the end of 
the buffer, the new last line becomes the current line. 


The e dit command causes the entire contents of the buffer 
to be deleted, and then the named file to be read in; . is set 
to the last line of the buffer. If no file name is given, the 
currently-remembered file name, if any, is used (see the f 
command). The number of characters read is typed; file is 
remembered for possible use as a default file name in sub- 
sequente,r, andw commands. lt file is replaced by !, the 
rest of the line is taken to be a shell (sh(1)) command 
whose output is to be read. Such a shell command is not 
remembered as the current file name. See also DIAGNOS- 
TICS below. 


The E dit command is like e , except that the editor does 
not check to see if any changes have been made to the 
buffer since the last w command. 


If file is given, the f ile-name command changes the 
currently-remembered file name to file ; otherwise, it prints 
the currently-remembered file name. 


(1,$)g/RE/comman 
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In the g /jobal command, the first step is to mark every line 
that matches the given RE. Then, for every such line, the 
given command fist is executed with . initially set to that 
line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines 
of a multi-line list except the last line must be ended with a 
\; a, /, and c commands and associated input are permit- 
ted. The. terminating input mode may be omitted if it would 
be the last line of the command list . An empty command 
list is equivalent to the p command. Theg,G,v,andV 
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commands are not permitted in the command list . See also 
BUGS and the last paragraph before FILES below. 


(1,$)G/RE/ 

In the interactive G jobal command, the first step is to mark 
every line that matches the given RE. Then, for every such 
line, that line is printed, . is changed to that line, and any 
one command (other than one of thea,c,/,g,G,v, 
and V commands) may be input and is executed. After the 
execution of that command, the next marked line is printed, 
and so on; a new-line acts as a null command; an & causes 
the re-execution of the most recent command executed 
within the current invocation of G . Note that the commands 
input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command 
can be terminated by an interrupt signal (ASCIl DEL or 
BREAK). 


The fh elp command gives a short error message that 
explains the reason for the most recent ? diagnostic. 


The H elp command causes ed to enter a mode in which 
error messages are printed for all subsequent ? diagnostics. 
It will also explain the previous ? if there was one. The H 
command alternately turns this mode on and off; it is initially 
off. 

(.)i 


<text> 


The i nsert command inserts the given text before the 
addressed line; . is left at the last inserted line, or, if there 
were none, at the addressed line. This command differs 
from the a command only in the placement of the input text. 
Address 0 is not legal for this command. The maximum 
number of characters that may be entered from a terminal is 
256 per line (including the new-line character). 


(.,.+1)j 
The j ofn command joins contiguous lines by removing the 
appropriate new-line characters. If exactly one address is 
given, this command does nothing. 

(.)kx | 
The mark command marks the addressed line with name x , 
which must be a lower-case letter. The address ‘x then 
addresses this line; . is unchanged. 
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The / ist command prints the addressed lines in an unambi- 
guous way: a few non-printing characters (e.g., tab, back- 
Space ) are represented by (hopefully) mnemonic over- 
strikes. All other non-printing characters are printed in 
octal, and long lines are folded. An / command may be 
appended to any other command other thane, f,r,orw. 


(.,.)ma 
The m ove command repositions the addressed line(s) after 
the line addressed by a . Address 0 Is legal for a and 
causes the addressed line(s) to be moved to the beginning 
of the file. It is an error if address a falls within the range of 
moved lines; . is left at the last line moved. 


The n umber command prints the addressed lines, preced- 
ing each line by its line number and a tab character; . is left 
at the last line printed. The n command may be appended 
to any other command other thane, f,r,orw. 


The p rint command prints the addressed lines; . is left at 
the last line printed. The p command may be appended to 
any other command other thane, f,r,orw. For example, 
dp deletes the current line and prints the new current line. 


p 
The editor will prompt with a * for all subsequent com- 
mands. The P command alternately turns this mode on and 
off; it is initially off. 

q 
The q uit command causes ed to exit. No automatic write 
of a file is done (but see DIAGNOSTICS below). 

Q 


The editor exits without checking if changes have been 
made in the buffer since the last w command. 


($)r file 
The r ead command reads in the given file after the 
addressed line. If no file name is given, the currently- 
remembered file name, if any, is used (see e and f com- 
mands). The currently-remembered file name is_ not 
changed unless file is the very first file name mentioned 
since ed was invoked. - Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read 
is successful, the number of characters read is typed; . is 
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put is to be read. For example, “$r !ls" appends current 
directory to the end of the file being edited. Such a shell 
command is not remembered as the current file name. 


(.,-)S/ RE / replacement ' or 
(.,-)s/ RE / replacement ‘g or 
(.,-)s/ RE / replacement 'n n= 1-512 


The s ubstitute command searches each addressed line for 
an occurrence of the specified RE. In each line in which a 
match is found, all (non-overlapped) matched strings are 
replaced by the replacement if the global replacement indi- 
cator g appears after the command. If the global indicator 
does not appear, only the first occurrence of the matched 
string is replaced. !f a number n appears after the com- 
mand, only the n th occurrence of the matched string on 
each addressed line is replaced. It is an error for the substi- 
tution to fail on ali addressed lines. Any character other 
than space or new-line may be used instead of / to delimit 
the RE and the replacement ; . is left at the last line on 


which a substitution occurred. See also the last paragraph - 


before FILES below. 


An ampersand (&) appearing in the replacement is 
replaced by the string matching the RE on the current line. 
The special meaning of & in this context may be 
suppressed by preceding it by \. AS a more general 
feature, the characters \n, where n is a digit, are replaced 
by the text matched by the n -th regular subexpression of 
the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n Is determined 
by counting occurrences of \( starting from the left. When 
the character % is the only character in the replacement , 
the replacement used in the most recent substitute com- 
mand is used as the replacement in the current substitute 
command. The % loses its special meaning when it is in a 
replacement string of more than one character or is pre- 
ceded by a \. 


A line may be split by substituting a new-line character into 
it. The new-line in the replacement must be escaped by 
preceding it by \. Such substitution cannot be done as part 
of ag or v command list. 


This command acts just like the m command, except that a 
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copy of the addressed lines is placed after address a 
(which may be 0); . is left at the last line of the copy. 


The u ndo command nullifies the effect of the most recent 
command that modified anything in the buffer, namely the 
most recenta,c,d,g,/,/,m,r,s,t,v,G,orv 
command. 


(1,$)v/RE’comman 


This command is the same as the global command g 
except that the command list is executed with . initially set 
to every line that does not match the RE. 


(1,$)V/RE! 


This command is the same as the interactive global com- 
mand G except that the lines that are marked during the 
first step are those that do not match the RE. 


(1,$)w file 
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The w rite command writes the addressed lines into the 
named file. lf the file does not exist, it is created with mode 
666 (readable and writable by everyone), unless your 


umask setting (see sh (71)) dictates otherwise. The 


currently-remembered file name is not changed unless file 
is the very first file name mentioned since ed was invoked. 
If no file name is given, the currently-remembered file name, 
if any, is used (see e and f commands); . is unchanged. If 
the command is successful, the number of characters writ- 
ten is typed. If file is replaced by !, the rest of the line is 
taken to be a shell (sh(1)) command whose standard input 
is the addressed lines. Such a shell command is not 
remembered as the current file name. 


A key string is demanded from the standard input. Subse- 
quent e,r, and w commands will encrypt and decrypt the 
text with this key by the algorithm of crypt (7). An explicitly 
empty key turns off encryption. 
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($)= 


The line number of the addressed line is typed; . is — 


unchanged by this command. 


Ishell command 

The remainder of the line after the ! is sent to the UNIX sys- 
tem shell (sh(1)) to be interpreted as a command. Within 
the text of that command, the unescaped character % is 
replaced with the remembered file name; if a ! appears as 
the first character of the shell command, it is replaced with 
the text of the previous shell command. Thus, !! will repeat 
the last shell command. If any expansion is performed, the 
expanded line is echoed; . is unchanged. 


(.+1) <new-line> 
An address alone on a line causes the addressed line to be 
printed. A new-line alone is equivalent to .+ 1p; it is useful 
for stepping forward through the buffer. 


lf an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and 
returns to its command level. 


Some size limitations: 512 characters per line, 256 characters per . 
global command list, 64 characters per file name, and 128K charac- | 
— ters in the buffer. The limit on the number of lines depends on the 


amount of user memory: each line takes 1 word. 


When reading a file, ed discards ASCII NUL characters and all char- 
acters after the last new-line. Files (e.g., a.out ) that contain char- 
acters not in the ASCII set (bit 8 on) cannot be edited by ed . 


If the closing delimiter of a RE or of a replacement string (e.g., /) 
would be the last character before a new-line, that delimiter may be 
omitted, in which case the addressed line is printed. The following 
pairs of commands are equivalent: 

s/s1/s2 S'S1,s2/p 


g/s1 g/s1ip 
?s1 ?s1? 
FILES 3 
itmp/e# temporary; # is the process number. 
ed.hup — work is saved here if the terminal is hung up. 
DIAGNOSTICS 
? for command errors. 
? file for an inaccessible file. 
(use the A elp and H e/p commands for detailed expla- 
nations). 


If changes have been made in the buffer since the last w command 
that wrote the entire buffer, ed warns the user if an attempt is made 
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( - to destroy ed ’s buffer via the e or q commands. It prints ? and 
allows one to continue editing. A second e or g command at this 
point will take effect. The -— command-line option inhibits this 

feature. 


SEE ALSO | 
crypt(1), grep(1), sed(1), sh(1), stty(1). 
fspec(4), regexp(5) in the Sys5 UNIX Programmer Reference 
Manual. 


Sys5 UNIX Editing Guide. 


CAVEATS AND BUGS 
A ! command cannot be subject to a g or a v command. 
The ! command and the ! escape from the e, r, and w commands 
cannot be used if the the editor is invoked from a restricted shell 
(see sh (1)). 
The sequence \n in a RE does not match a new-line character. 
The / command mishandles DEL. 
Files encrypted directly with the crypt (7) command with the null key 
cannot be edited. 
ee Characters are masked to 7 bits on input. 
( If the editor input is coming from a command file (i.e., ed file < ed- 
3 cmd-file), the editor will exit at the first failure of a command that is 

in the command file. 
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NAME "a | 

edit — text editor (variant of ex for casual users) 
SYNOPSIS 

edit [ -r ] name ... 
DESCRIPTION 


Edit is a variant of the text editor ex recommended for new or 
casual users who wish to use a command-oriented editor. The fol- 
lowing brief introduction should help you get started with edit. If you 
are using a CAT terminal you may want to learn about the display 
editor vi. 


BRIEF INTRODUCTION 
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To edit the contents of an existing file you begin with the command 
“edit filename” to the shell. Edit makes a copy of the file which you 
can then edit, and tells you how many lines and characters are in 
the file. To create a new file, just make up a name for the file and 
try to run edit on it; you will cause an error diagnostic, but do not 
worry. 


Edit prompts for commands with the character ‘:’, which you should 
see after starting the editor. If you are editing an existing file, then 


you will have some lines in edit's buffer (its name for the copy of the “ 
file you are editing). Most commands to edit use its “current line” if — 


you do not tell them which line to use. Thus if you say print (which 
can be abbreviated p) and hit carriage return (as you should after all 
edit commands) this current line will be printed. If you delete (d) 
the current line, edit will print the new current line. When you start 
editing, edit makes the last line of the file the current line. If you 
delete this last line, then the new last line becomes the current one. 
In general, after a delete, the next line in the file becomes the 
current line. (Deleting the last line ig a special case.) 


If you start with an empty file or wish to add some new lines, then 
the append (a) command can be used. After you give this com- 
mand (typing a carriage return after the word append) edit will read 
lines from your terminal until you give a line consisting of just a “.”, 
placing these lines after the current line. The last line you type then 
becomes the current line. The command insert (i) is like append 
but places the lines you give before, rather than after, the current 
line. 


Edit numbers the lines in the buffer, with the first line having number 
1. If you give the command “1” then edit will type this first line. If 
you then give the command delete edit will delete the first line, line 
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2 will become line 1, and edit will print the current line (the new line 
1) so you can see where you are. In general, the current line will 
always be the last line affected by a command. 


You can make a change to some text within the current line by 
using the substitute (s) command. You say “s/old/new/” where 
old is replaced by the old characters you want to get rid of and new 
is the new characters you want to replace it with. 


The command file (f) will tell you how many lines there are in the 
buffer you are editing and will say “[Modified]” if you have changed 
it. After modifying a file you can put the buffer text back to replace 
the file by giving a write (w) command. You can then leave the edi- 
tor by issuing a quit (q) command. If you run edit on a file, but do ~ 
not change it, it is not necessary (but does no harm) to write the file 
back. If you try to quit from edit after modifying the buffer without 
writing it out, you will be warned that there has been “No write 
since last change” and edit will await another command. If you wish 
not to write the buffer out then you can issue another quit com- 
mand. The buffer is then irretrievably discarded, and you return to 
the shell. 


By using the delete and append commands, and giving line 
numbers to see lines in the file you can make any changes you 
desire. You should learn at least a few more things, however, if you 
are to use edit more than a few times. 


The change (c) command will change the current line to a 
sequence of lines you supply (as in append you give lines up to a 
line consisting of only a “."). You can tell change to change more 
than one line by giving the line numbers of the lines you want to 
change, i.e., “3,5change”. You can print lines this way too. Thus 
“1,23p" prints the first 23 lines of the file. 


The undo (u) command will reverse the effect of the last command 
you gave which changed the buffer. Thus if you give a substitute 
command which does not do what you want, you can say undo and 
the old contents of the line will be restored. You can also undo an 
undo command so that you can continue to change your mind. Edit 
will give you a warning message when commands you do affect 
more than one line of the buffer. If the amount of change seems 
unreasonable, you should consider doing an undo and looking to 
see what happened. If you decide that the change is ok, then you 
can undo again to get it back. Note that commands such as write 
and quit cannot be undone. 


To look at the next line in the buffer you can just hit carriage return. 
To look at a number of lines hit ‘D (control key and, while it is held 
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down D key, then let up both) rather than carriage return. This will . 
show you a half screen of lines on a CRT or 12 lines on a hardcopy ° 


terminal. You can look at the text around where you are by giving 
the command “z.". The current line will then be the last line printed; 
you can get back to the line where you were before the “z.” com- 
mand by saying “°’. The z command can also be given other fol- 
lowing characters “z—" prints a screen of text (or 24 lines) ending 
where you are; “z+” prints the next screenful. If you want less than 
a screenful of lines, type in "z.12" to get 12 lines total. This method 
of giving counts works in general; thus you can delete 5 lines start- 
ing with the current line with the command “delete 5”. 


To find things in the file, you can use line numbers if you happen to 
know them; since the line numbers change when you insert and 
delete lines this is somewhat unreliable. You can search backwards 
and forwards in the file for strings by giving commands of the form 
/text/ to search forward for text or ?text? to search backward for 
text. If a search reaches the end of the file without finding the text it 
wraps, end around, and continues to search back to the line where 
you are. A useful feature here is a search of the form /“text/ which 
searches for text at the beginning of a line. Similarly /text$/ 


searches for fext at the end of a line. You can leave off the trailing / 


or ? in these commands. 


The current line has a symbolic name *."; this is most useful in a 
range of lines as in “.,Sprint” which prints the rest of the lines in the 
file. To get to the last line in the file you can refer to it by its sym- 
bolic name “$". Thus the command “$ delete” or “$d” deletes the 
last line in the file, no matter which line was the current line before. 
Arithmetic with line references is also possible. Thus the line “$—5” 
is the fifth before the last, and “.+20” is 20 lines after the present. 


You can find out which line you are at by doing “.=". This is useful 
if you wish to move or copy a section of text within a file or between 
files. Find out the first and last line numbers you wish to copy or 
move (say 10 to 20). For a move you can then say “10,20delete a’ 
which deletes these lines from the file and places them in a buffer 
named a. Edit has 26 such buffers named a through z. You can 
later get these lines back by doing “put a’ to put the contents of 
buffer a after the current line. If you want to move or copy these 
lines between files you can give an edit (e) command after copying 
the lines, following it with the name of the other file you wish to edit, 
i.e., “edit chapter2”. By changing delete to yank above you can get 
a pattern for copying lines. If the text you wish to move or copy is 


all within one file then you can just say “10,20move $" for example. | 


It is not necessary to use named buffers in this case (but you can if 
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( you wish). 
} 
~ SEE ALSO 


ex(1), vi(1). 
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NAME | 
efl — Extended Fortran Language 


SYNOPSIS 
efl [ options | [ files ] 


DESCRIPTION 
Eff compiles a program written in the EFL language into clean For- 
tran on the standard output. Eff provides the C-like control con- 
structs of ratfor (1): 


statement grouping with braces. 


decision-making: 
if , if - else , and select - case (also known as 
switch - case ); 
while , for , Fortran do , repeat , and repeat ... 
until loops; 
multi-level break and next. 


EFL has C-like data structures, e.g.: 


struct 
{ 
integer flags(3) 
character(8) name 
long real coords(2) 
} table(100) 


The language offers generic functions, assignment operators (+ =, 
&= , etc.), and sequentially evaluated logical operators (&& and || 
). There is a uniform input/output syntax: 


write(6,x,y:f(7,2), do i=1,10 { a(i,j),z.b(i) }) 
EFL also provides some syntactic “sugar”: 


free-form input: 
multiple statements per line; automatic continuation; 
statement label names (not just numbers). 


comments: 
# this is a comment. 


translation of relational and logical operators: 
>,>=,4&, etc., become .GT. , .GE. , .AND. , etc. 


return expression to caller from function: 
return (expression) 
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oT defines: 
( define name replacement 


includes: 
include file 


Eff understands several option arguments: —w suppresses warning 
messages, -# suppresses comments in the generated program, 
and the default option -C causes comments to be included in the 
generated program. 


An argument with an embedded — (equal sign) sets an EFL option 
as if it had appeared in an option statement at the start of the pro- 
gram. Many options are described in the reference manual. A set — 
of defaults for a particular target machine may be selected by one of 
the choices: system unix , system gcos , or system cray. 
The default setting of the system option is the same as the machine 
the compiler is running on. Other specific options determine the 
style of input/output, error handling, continuation conventions, the 
number of characters packed per word, and default formats. 


Ef! is best used with f77 (7). 


SEE ALSO 
cc(1), f77(1), ratfor(1). 
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NAME _— 
enable, disable — enable/disable LP printers 


SYNOPSIS 
enable printers 
disable [-c] [-r[reason]] printers 


DESCRIPTION 
Enable activates the named printers , enabling them to print 
requests taken by /p (7). Use /pstat (1) to find the status of printers. 


Disable deactivates the named printers , disabling them from print- 
ing requests taken by /p (7). By default, any requests that are 
currently printing on the designated printers will be reprinted in their 
entirety either on the same printer or on another member of the 
same class. Use /pstat (1) to find the status of printers. Options 
useful with disable are: 


—Cc Cancel any requests that are currently printing on any 
of the designated printers. 

-r [reason] Associates a reason with the deactivation of the 
printers. This reason applies to all printers mentioned 
up to the next -r option. If the —-r option is not present 
or the -r option is given without a reason, then a - a 
default reason will be used. Reason is reported by © 
Ipstat (1). 

FILES 

/uSt/spool/|p/* 
SEE ALSO 

Ip(1), Ipstat(1). 
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NAME 
( . env — set environment for command execution 
SYNOPSIS 
env [-] [ name=value ] .... [ command args ] 
DESCRIPTION 


Env obtains the current environment , modifies it according to its 
arguments, then executes the command with the modified environ- 
ment. Arguments of the form name=value are merged into the 
inherited environment before the command is executed. The — flag 
causes the inherited environment to be ignored completely, so that 
the command is executed with exactly the environment specified by 
the arguments. 


lf no command is specified, the resulting environment is printed, one 
name-value pair per line. 

SEE ALSO 
sh(1). 
exec(2), profile(4), environ(5) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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NAME 

eqn, neqn, checkeq — format mathematical text for nroff or troff 
SYNOPSIS 

eqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ —Tdest ] [ files ] 

neqn [ —dxy ] [ -—pn ] [ -sn ] [ -fn ] [ files ] 

checkeq [ files ] 
DESCRIPTION 
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Eqn is a troff(1) preprocessor for typesetting mathematical text on a 
phototypesetter, while neqn is used for the same purpose with nroff 
on typewriter-like terminals. Usage is almost always: 


eqn files | troff 
neqn files | nroff 


or equivalent. If no files are specified (or if — is specified as the last 
argument), these programs read the standard input. Eqn prepares 
output for the typesetter named in the —T option. Currently sup- 
ported devices are —Taps (Autologic APS-5), -TX97 (Xerox 9700), 
-Ti10 (Imagen Imprint-10), and -—Tcat (Wang CAT). Default is 
—Taps. 


A line beginning with .EQ marks the start of an equation; the end of 


an equation is marked by a line beginning with .EN. Neither of these 7 


lines is altered, so they may be defined in macro packages to get ~ 


centering, numbering, etc. It is also possible to designate two char- 
acters as delimiters; subsequent text between delimiters is then 
treated as eqn input. Delimiters may be set to characters x and y 
with the command-line argument —dxy or (more commonly) with 
delim xy between .EQ and .EN. The left and right delimiters may be 
the same character; the dollar sign is often used as such a delimiter. 
Delimiters are turned off by delim off. All text that is neither 
between delimiters nor between .EQ and .EN is passed through 
untouched. 


The program checkeq reports missing or unbalanced delimiters and 
-EQ/.EN pairs. 


Tokens within eqn are separated by spaces, tabs, new-lines, 
braces, double quotes, tildes, and circumflexes. Braces {} are used 
for grouping; generally speaking, anywhere a single character such 
as x could appear, a complicated construction enclosed in braces 
may be used instead. Tilde (~) represents a full space in the output, 
circumflex (*) half as much. | 


a 


7 


Subscripts and superscripts are produced with the keywords sub “ — 
2 | 
and sup. Thus x sub {| makes Xj, a sub k sup 2 produces a, , 


. t 
while e* ” 


is made with "e sup {x sup 2 + y sup 2}". Fractions 
a 
are made with over: a over b yields —; sqrt makes square roots: 
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Fee oe we he oe . 
Vax~+bx+c 


Ra ay n 


( : 1 over sqrt {ax sup 2+bx+c} results in 


The keywords from and to introduce lower and upper limits: lim x, 
n-w-x 
is made with fim from {n —> inf-} sum from 0 ton x subi. Left 
and right brackets, braces, etc., of the right height are made with 
left and right: /eft [ x sup 2 + y sup 2 over alpha right ] ~=~ 1 
2 


produces pre = 1. Legal characters after left and right are 
Ql 

braces, brackets, bars, c and f for ceiling and floor, and "" for noth- 

ing at all (useful for a right-side-only bracket). A left thing need not — 

have a matching right thing. 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: 
a 
pile {a above b above c} produces b. Piles may have arbitrary 


Cc 
numbers of elements; Ipile left-justifies, pile and cpile center (but 
with different vertical spacing), and rpile right justifies. Matrices are 
made with matrix: matrix { [col { x sub i above y sub 2 } ccol { 17 


P| ° / 

( above 2 } } produces ie In addition, there is rcol for a right- 

2 
justified column. 


Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, 
dyad, and under: x dot =( int ) (t) bar yields x=(f)(6), 
y dotdot bar~=~nunder is y =n, and x vec ~=- y dyad is 
X =y. 

Point sizes and fonts can be changed with size n or size +n, 
roman, italic, bold, and font n. Point sizes and fonts can be 


changed globally in a document by gsize n and gfont r, or by the 
command-line arguments —sn and —fn. 


Normally, subscripts and superscripts are reduced by 3 points from 
the previous size; this may be changed by the command-line argu- 
ment —pn. 


Successive display arguments can be lined up. Place mark before 
the desired lineup point in the first equation; place lineup at the 
place that ts to line up vertically in subsequent equations. 


Shorthands may be defined or existing keywords redefined with 
define: 


define thing % replacement % 
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defines a new token called thing that will be replaced by replace- 


ment whenever it appears thereafter. The % may be any character ‘ are 


that does not occur in replacement. 


Keywords such as sum (»), int ([), inf (:), and shorthands such 
as >= (=), != (#), and —> (-) are recognized. Greek letters are 
spelled out in the desired case, as in alpha (a), or GAMMA (T). 
Mathematical words such as sin, cos, and log are made Roman 
automatically. Troff(1) four-character escapes such as \(dd (+) and 
\(sc (§) may be used anywhere. Strings enclosed in double quotes 
("...") are passed through untouched; this permits keywords to be 
entered as text, and can be used to communicate with troff(1) when 
all else fails. Full details are given in the manual cited below. 


SEE ALSO 


BUGS 
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mm(1), mmt(1), nroff(1), tol(1), troff(1), eqnchar(5), mm(5), mv(5). 


Typesetting Mathematics—User Guide by B. W. Kernighan and L. L. 
Cherry. 


To embolden digits, parentheses, etc., it is necessary to quote 
them, as in bold "12.3". 
See also BUGS under troff(1). 


Some things do not work correctly. Diacritical marks are too close 


to the letters they should be above and the matrix columns use too 
much space (see examples on preceding page). There may be 
other problems. For some things the Sys3 version of eqn may work 
better. 
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NAME 
ex — text editor 
SYNOPSIS 
ex [-][-—v][ tag ] [—-+][—-RJ]{[{+command ][-I] [ 
~-x | name ... 
DESCRIPTION 


Ex is the root of a family of editors: ex and vi. Ex is a superset of 
ed, with the most notable extension being a display editing facility. 
Display based editing is the focus of vi. 


If you have a CRT terminal, you may wish to use a display based 
editor; in this case see vi (7), which is a command which focuses 
on the display editing portion of ex. 


DOCUMENTATION 


The Ex Reference Manual is a comprehensive and complete 
manual for the command mode features of ex, but you cannot learn 
to use the editor by reading it. For an introduction to more 
advanced forms of editing using the command mode of ex see the 
editing documents written by Brian Kernighan for the editor ed; the 
material in the introductory and advanced documents works also 
with ex. 


An Introduction to Display Editing with Vi introduces the display 
editor vi and provides reference material on v/. The Vi Quick Refer- 
ence card summarizes the commands of wi in a useful, functional 
way, and is useful with the /ntroduction. The vi(1) manual page can 
also be used as reference. 


FOR ED USERS 
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If you have used ed you will find that ex has a number of new 
features useful on CRT terminals. Intelligent terminals and high 
speed terminals are very pleasant to use with v/. Generally, the edi- 
tor uses far more of the capabilities of terminals than ed does, and 
uses the terminal capability data base terminfo (4) and the type of 
the terminal you are using from the variable TERM in the environ- 
ment to determine how to drive your terminal efficiently. The editor 
makes use of features such as insert and delete character and line 
in its visual command (which can be abbreviated vi) and which is 
the central mode of editing when using vi (7). 


Ex contains a number of new features for easily viewing the text of 
the file. The z command gives easy access to windows of text. Hit- 
ting “D causes the editor to scroll a half-window of text and is more 
useful for quickly stepping through a file than just hitting return. Of 
course, the screen-oriented visual mode gives constant access to 
editing context. 
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Ex gives you more help when you make mistakes. The undo (u) _ 
command allows you to reverse any single change which goes“ 
astray. Ex gives you a lot of feedback, normally printing changed Ne 


lines, and indicates when more than a few lines are affected by a 
command so that it is easy to detect when a command has affected 
more lines than it should have. 


The editor also normally prevents overwriting existing files unless 
you edited them so that you do not accidentally clobber with a write 
a file other than the one you are editing. If the system (or editor) 
crashes, or you accidentally hang up the phone, you can use the 
editor recover command to retrieve your work. This will get you 
back to within a few lines of where you left off. 


Ex has several features for dealing with more than one file at a 
time. You can give it a list of files on the command line and use the 
next (n) command to deal with each in turn. The next command 
can also be given a list of file names, or a pattern as used by the 
shell to specify a new set of files to be dealt with. In general, 
filenames in the editor may be formed with full shell metasyntax. 
The metacharacter ‘%' is also available in forming filenames and is 
replaced by the name of the current file. 


For moving text between files and within a file the editor has a group ~~ 


of buffers, named a through z. You can place text in these named . 


buffers and carry it over when you edit another file. 


There is a command & in ex which repeats the last substitute com- 
mand. In addition there is a confirmed substitute command. You 
give a range of substitutions to be done and the editor interactively 
asks whether each substitution is desired. 


It is possible to ignore case of letters in searches and substitutions. 
Ex also allows regular expressions which match words to be con- 
structed. This is convenient, for example, in searching for the word 
“edit” if your document also contains the word “editor.” 


Ex has a set of options which you can set to tailor it to your liking. 
One option which is very useful is the autoindent option which 
allows the editor to automatically supply leading white space to align 
text. You can then use the “D key as a backtab and space and tab 
forward to align new code easily. 


Miscellaneous new useful features include an intelligent join (j) 
command which supplies white space between joined lines automat- 
ically, commands < and > which shift groups of lines, and the abil- 
ity to filter portions of the buffer through commands such as sort. 


INVOCATION OPTIONS 


The following invocation options are interpreted by ex : 


May 16, 1986 Page 2 


( 


EX(1) 


+command 


—X 


UNIX Sys5 EX(1) 


Suppress all interactive-user feedback. This is 
useful in processing editor scripts. 


Invokes vi 


Edit the file containing the tag and position the edi- 
tor at its definition. 


Recover file after an editor or system crash. If file 
is not specified a list of all saved files will be 
printed. 


Readonly mode set, prevents accidentally overwrit- 
ing the file. 

Begin editing by executing the specified editor 
search or positioning command. 

LISP mode; indents appropriately for lisp code, the 


() {} [[ and ]] commands in vi are modified to have 
meaning for lisp . 


Encryption mode; a key is prompted for allowing 
creation or editing of an encrypted file. 


The name argument indicates files to be edited. 


Ex States 


Command 


Insert 


Visual 


Normal and initial state. Input prompted for by :. 
Your kill character cancels partial command. 


Entered by a i and c. Arbitrary text may be 
entered. Insert is normally terminated by line hav- 
ing only . on it, or abnormally with an interrupt. 


Entered by vi, terminates with Q or ‘\. 


Ex command names and abbreviations 


abbrev 
append 
args 
change 
copy 
delete 
edit 

file 
global 
insert 
join 

list 
map 
mark 
move 
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ab 


next n unabbrev una 
number nu undo u 
unmap unm 
preserve pre version ve 
print p visual vi 
put pu write w 
quit q xit X 
read re yank ya 
recover rec window Zz 
rewind rew escape ! 
set se Ishift < 
shell sh print next CR 
source so resubst & 
stop st rshift > 
substitute $s scroll “D 
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Ex Command Addresses 
n line n 
. current 
$ last 
+ next 
_ previous 
+n n forward 
% 1,$ 


Initializing options 
EXINIT 
$HOME/.exrc 
./.@xXre 
set x __ 
set nox 
set x=val 
set 
set all 
set x? 


Most useful options 
autoindent 
autowrite 
ignorecase 
lisp 
list 
magic 
number 
paragraphs 
redraw 
scroll 
sections 
shiftwidth 
showmatch 
showmode 
slowopen 
window 
wrapscan 
wrapmargin 


UNIX Sys5 


pat next with pat 
?pat previous with pat 
x-n n before x 

X,Y x through y 

x marked with x 
previous context 


place set's here in environment var. 


editor initialization file 
editor initialization file 
enable option 

disable option 

give value va/ 

show changed options 
show all options 

show value of option x 


al supply indent 
aw write before changing files 
Ic In scanning 


() { } are s-exp’s 
print ‘| for tab, $ at end 
. [ * special in patterns 
nu number lines 
para macro names which start ... 
simulate smart terminal 
command mode lines 
sect macro names ... 
SW for < >, and input *D 
sm to ) and } as typed 
smd — show insert mode in vi 
slow stop updates during insert 
visual mode lines 
ws around end of buffer? 
wm automatic line splitting 


Scanning pattern formation 


$ 
\< 
\> 


[str] 
[tstr] 
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beginning of line 
end of line 

any character 
beginning of word 
end of word 

any char in str 

... Not in str 


EX(1) 
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[x—y] ... between x and y 
| ° any number of preceding 
~ AUTHOR 


Vi and ex are based on software developed by The University of 
California, Berkeley California, Computer Science Division, Depart- 
ment of Electrical Engineering and Computer Science. 


FILES 
/usr/lib/ex?.?strings error messages 
/usr/lib/ex?. ?recover recover command 
/usr/lib/ex?.?preserve preserve command 
/ustr/ib/*/* describes capabilities of terminals 
$HOME/.exrc editor startup file 
S.EX1C editor startup file 
/tmp/Exnnnnn editor temporary 
/tmp/Rxnnnnn named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 


( CAVEA 
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awk(1), ed(1), edit(1), grep(1), sed(1), vi(1). 
curses(3X), term(4), terminfo(4) in the Sys5 UNIX Programmer 
Reference Manual. 


TS AND BUGS 
The undo command causes all marks to be lost on lines changed 
and then restored if the marked lines were changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical 
lines. More than a screen full of output may result if long lines are 
present. 


File input/output errors do not print a name if the command line ‘~’ 
option is used. 


There is no easy way to do a single scan ignoring case. 


The editor does not warn if text is placed in named buffers and not 
used before exiting the editor. 


Null characters are discarded in input files and cannot appear in 
resultant files. 
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NAME 


expr — evaluate arguments as an expression 


SYNOPSIS 


expr arguments 


DESCRIPTION : 


Page 1 


The arguments are taken as an expression. After evaluation, the 
result is written on the standard output. Terms of the expression 
must be separated by blanks. Characters special to the shell must 
be escaped. Note that 0 is returned to indicate a zero value, rather 
than the null string. Strings containing blanks or other special char- 
acters should be quoted. Integer-valued arguments may be pre- 
ceded by a unary minus sign. Internally, integers are treated as 
32-bit, 2s complement numbers. 


The operators and keywords are listed below. Characters that need 
to be escaped are preceded by \. The list is in order of increasing 
precedence, with equal precedence operators grouped within {} 
symbols. 


expr \| expr 
returns the first expr if it is neither null nor 0, otherwise 
returns the second expr . 


expr \& expr 
returns the first expr if neither expr is null or 0, otherwise 
returns 0. 


expr { =,\>,\>=, \<, \<=, != } expr 
returns the result of an integer comparison if both argu- 
ments are integers, otherwise returns the result of a lexical 
comparison. 


expr { +,—} expr 
addition or subtraction of integer-valued arguments. 


expr { \*, /, % } expr 
multiplication, division, or remainder of the integer-valued 
arguments. 


expr : expr 

The matching operator : compares the first argument with 
the second argument which must be a regular expression. 
Regular expression syntax is the same as that of ed (7), 
except that all patterns are “anchored” (i.e., begin with *) 
and, therefore, ~ is not a special character, in that context. 
Normally, the matching operator returns the number of char- 
acters matched (0 on failure). Alternatively, the \(...\) 
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EXPR(1) 
-_ 


pattern symbols can be used to return a portion of the first 
| a 


argument. 
EXAMPLES 
1s a=*expr $a + 1° 

adds 1 to the shell variable a . 


# For $a equal to either "/usr/abc/file" or just "file" ’ 


expr $a : *.*/A(.*\)’ \| $a 
returns the last segment of a path name (i.e., file) 
Watch out for / alone as an argument: expr will take 


it as the division operator (see BUGS below) 


# A better representation of example 2. 


expr //$a :  7.#/\(2*\) 
The addition of the // characters eliminates any 


ambiguity about the division operator and simplifies 
the whole expression. 


4. expr $VAR : 7.*” 
returns the number of characters in $SVAR 


SEE ALSO 
ed(1), sh(1). 


EXIT CODE , 
As a side effect of expression evaluation, expr returns the following 


exit values: 
0 if the expression is neither null nor 0 
1 if the expression /s null or 0 
2 for invalid expressions. 


DIAGNOSTICS 
syntax error ; for operator/operand errors 
non-numeric argument if arithmetic is attempted on such a string 


BUGS 
After argument processing by the shell, expr cannot tell the differ- 
ence between an operator and an operand aa by the value. If 


$a is an = , the command: 


expr $a 
looks like: 


expr = = = 
as the arguments are passed to expr (and they will all be taken as eX 


the = operator). The — works: 


— 


expr X$a = X= 


em 7 
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NAME 


{77 — Fortran 77 compiler 


~ SYNOPSIS 


f77 [ options ] files 


DESCRIPTION | 
F77 is the UNIX System Fortran 77 compiler; it accepts several 
types of file arguments: 


Arguments whose names end with .f are taken to be Fortran 
77 source programs; they are compiled and each object 
program is left in the current directory in a file whose name 
is that of the source, with .o substituted for .f . 


Arguments whose names end with .r or .e are taken to be — 
RATFOR or EFL source programs, respectively. These are 
first transformed by the appropriate preprocessor, then com- 
piled by f77 , producing .o files. | 


In the same way, arguments whose names end with .c or .s 
are taken to be C or assembly source programs and are 
compiled or assembled, producing .o files. 


The following options have the same meaning as in cc (1) (see Id 
(17) for link editor options): 


—C Suppress link editing and produce .o files for each 
source file. 

—p Prepare object files for profiling (see prof ( 1)). 

-O Invoke an object-code optimizer. 

-S Compile the named _ programs and . leave the 


assembler-language output in corresponding files 
whose names are suffixed with .s . (No .o files are 


created.) 
—ooutput Name the final output file output , instead of a.out . 
~f In systems without floating-point hardware, use a ver- 


sion of f77 that handles floating-point constants and 
links the object program with the floating- point inter- 
preter. 


The following options are peculiar to {77 : 


-onetrip Compile DO loops that are performed at least once if 
reached. (Fortran 77 DO loops are not performed at 
all if the upper limit is smaller than the lower lent. ) 


—1 Same as —onetrip . 

~—66 Suppress extensions which enhance Fortran 66 com- 
patibility. 

-C Generate code for run-time subscript range-checking. 

-U Do not "fold" cases. F77 is normally a no-case 


language (i.e., a is equal to A ). The —U option causes 
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—U 
—V 


—W 


a 


—m 


—E 
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f77 to treat upper and lower cases to be separate. 


Verbose mode. Provide diagnostics for each process 
during compilation. 

Suppress all warning messages. If the option is -w66 
, only Fortran 66 compatibility warnings are 
suppressed. 

Apply EFL and RATFOR preprocessor to relevant files, 
put the result in files whose names have their suffix 
changed to .f . (No .o files are created.) 

Apply the M4 preprocessor to each EFL or RATFOR 
source file before transforming with the ratfor (7) or eff 
(1) processors. 

The remaining characters in the argument are used as 
an EFL flag argument whenever processing a .e file. 
The remaining characters in the argument are used as 
a RATFOR flag argument whenever processing a .r file. 


Other arguments are taken to be either link-editor option arguments 
or f77 -compilable object programs (typically produced by an earlier 
run), or libraries of f77 -compilable routines. These programs, 
together with the results of any compilations specified, are linked (inv — 


the order given) to produce an executable program with the default yg 


name a.out . 
FILES 

file.[fresc] input file 

file.o object file 

a.out linked output 

.fort[pid].? temporary 

/usr/lib/f77pass1 compiler 

/usr/lib/f77passe2 . pass 2 

Nib/c2 optional optimizer 

/usr/lib/libF77.a intrinsic function library 

/usr/lib/lib!77.a Fortran I/O library | 

/lib/libc.a C library; see Section 3 of this Manual. 
SEE ALSO 

asa(1), cc(1), efl(1), fsplit(1), Id(1), m4(1), prof(1), ratfor(1). 
DIAGNOSTICS 


The diagnostics produced by f77 itself are intended to be self- 


explanatory. 
editor /d (1). 
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Make the default type of a variable undefined , rathe _ 
than using the default Fortran rules. : 


fr 


a 
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_ NAME 
. factor — factor a number 
’ SYNOPSIS 
factor [ number | 
DESCRIPTION 


When factor is invoked without an argument, it waits for a number 
to be typed in. If you type in a positive number less than 2°° (about 
7.2X 10'°) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another 
number. It exits if it encounters a zero or any non-numeric charac- 
ter. 


If factor is invoked with an argument, it factors the number as above 
and then exits. 


Maximum time to factor is proportional to Vn and occurs when n is 
prime or the square of a prime. 


DIAGNOSTICS 
“Ouch” for input out of range or for garbage input. 
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NAME 
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file — determine file type 


SYNOPSIS 


file [-c | [-f ffile][-—m mfile ] arg ... 


DESCRIPTION 


File performs a series of tests on each argument in an attempt to 
classify it. If an argument appears to be ASCII, file examines the 
first 512 bytes and tries to guess its language. If an argument is an 
executable a.out , fife will print the version stamp, provided it is 
greater than 0 (see /d (7)). 


If the -f option is given, the next argument is taken to be a file con- 
taining the names of the files to be examined. 


File uses the file /etc/magic to identify files that have some sort of 
magic number , that is, any file containing a numeric or string con- 
stant that indicates its type. Commentary at the beginning of 
/etc/magic explains its format. 


The —m option instructs file to use an alternate magic file. 


The —c flag causes file to check the magic file for format errors. 
This validation is not normally carried out for reasons of efficiency. 
No file typing is done under —c . 


SEE ALSO 
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Id(1). 
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NAME : 
find — find files ( = 

SYNOPSIS ee, 
find path-name-list expression 

DESCRIPTION ; 

Find recursively descends the directory hierarchy for each path 

name in the path-name-list (i.e., one or more path names) seeking 

files that match a boolean expression written in the primaries given 

below. In the descriptions, the argument n is used as a decimal 

integer where +n means more thann, —n means less thann andn 

means exactly n. 

—name file True if file matches the current file name. Normal 
shell argument syntax may be used if escaped 
(watch out for[, ? and * ). 

-inum # Will report on the file with the specified inode 
number. 

—perm onum True if the file permission flags exactly match the 
octal number onum (see chmod (1)). If onum is 
prefixed by a minus sign, more flag bits (017777, 
see stat (2)) become significant and the flags are 
compared. | . ; 

—type c True if the type of the file isc , wherec isb,c, 

d,p, or f for block special file, character special 
file, directory, fifo (a.k.a named pipe), or plain file 
respectively. 

—links n True if the file has rn links. 

—user uname True if the file belongs to the user uname . If 
uname is numeric and does not appear as a login 

‘name in the /etc/passwd file, it is taken as a user 
ID. 

-—group gname True if the file belongs to the group gname . If 
gname is numeric and does not appear in the 
/etc/group file, it is taken as a group ID. 

-size n[c] True if the file is n blocks long (512 bytes per 
block). If n is followed by ac, the size is in char- 
acters. 

-—atime n True if the file has been accessed inn days. The 
access time of directories in path-name-list is _ 
changed by find itself. —_ 

-—mtime n True if the file has been modified in n days. SS 
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—ctime n 


—exec cmd 


—ok cmd 


—print 
—cpio device 


—newer file 


—depth 


( expression ) 
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True if the file has been changed inn days. 


True if the executed cmd returns a zero value as 
exit status. The end of cmd must be punctuated 
by an escaped semicolon. A command argument 
{} is replaced by the current path name. 


Like -exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y . 


Always true; prints current path name. 


Always true; write the current file on device in 
cpio (4) format (5120-byte records). 


True if the current file has been modified more 
recently than the argument file . 


Always true; causes descent of the directory 
hierarchy to be done so that all entries in a direc- 
tory are acted on before the directory itself. This 
can be useful when find is used with cpio (1) to 
transfer files that are contained in directories 
without write permission. 


True if the parenthesized expression is true 
(parentheses must be escaped for the shell). 


The primaries may be combined using the following operators (in 
order of decreasing precedence): 


1) The negation of a primary (! is the unary not operator). 


2) Concatenation of primaries (the and operation is implied). 


3) Alternation of primaries (-o is the or operator). 


EXAMPLES 


Remove files named a.out or +.o not opened for a week: 


find / \( —name a.out —o —name '*.0’ \) -atime +7 —exec rm {} \; 


List all files except files beginning with the name focal: 


find /\( —-name ‘=’ |! —name local’*’ \) —print 


FILES 


/etc/passwd, /etc/group 


SEE ALSO 


chmod(1), cpio(1), sh(1), test(1). 
stat(2), cpio(4), fs(4) in the Sys5 UNIX Prog. Ref. Manual. 
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NAME 
fsplit — split f77, ratfor, or efl files 
SYNOPSIS se 
fsplit options files 


DESCRIPTION 

Fsplit splits the named file(s) into separate files, with one procedure 
per file. A procedure includes blockdata, function, main, program, 
and subroutine program segments. Procedure X is put in file X.f, 
X.r, or X.e depending on the language option chosen, with the fol- 
lowing exceptions: main is put in the file MAIN.[efr] and unnamed 
blockdata segments in the files blockdataN.[efr] where N is a 
unique integer value for each file. 


The following options pertain: 

—f (default) Input files are f77. 
—r Input files are ratfor . 

—e Input files are Eff. 


—S Strip f77 input lines to 72 or fewer characters with trailing 
blanks removed. 


SEE ALSO we 
esplit(1), efl(1), f77(1), ratfor(1), split(1). | 
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hpd, erase, hardcopy, tekset, td — graphical device routines and 


filters 


SYNOPSIS 
hpd [-options] [GPS file ...] 
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erase 
hardcopy 
tekset 


td [-eurn] [GPS file ...] 


DESCRIPTION 
All of the commands described below reside in /usr/bin/graf (see 
graphics (1G)). 


hpd 


erase 


hardcopy 


Hpd translates a GPS (see gps (4)), to instructions for 
the Hewlett-Packard 7221A Graphics Plotter. A viewing 
window is computed from the maximum and minimum 
points in file unless the —u or -r option is provided. If no 
file is given, the standard input is assumed. Options 
are: 
cn Select character set n , n between O and 5 (see 
the "HP72217A Plotter Operating and Programming 
Manual" ", " “Appendix A" ). 


pn Select pen numbered n , n between 1 and 4 
inclusive. 


rn Window on GPS region n , n between 1 and 25 
inclusive. 


sn Slant characters n degrees clockwise from the 
vertical. 


u Window on the entire GPS universe. 


xdn Set x displacement of the viewport’s lower left 
corner to n inches. 


xvn Set width of viewport to n inches. 


ydn Set y displacement of the viewport’s lower left 
corner to n inches. 


yvn Set height of viewport to n inches. 


Erase sends characters to a TEKTRONIX 4010 series 
storage terminal to erase the screen. 


When issued at a TEKTRONIX display terminal with a 
hard copy unit, hardcopy generates a screen copy on. 
the unit. 
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tekset Tekset sends characters to a TEKTRONIX terminal to 


Clear the display screen, set the display mode to alpha, 
and set characters to the smallest font. : 


td Td translates a GPS to scope code for a TEKTRONIX 
4010 series storage terminal. A viewing window is com- 
puted from the maximum and minimum points in file 
unless the —u or -r option is provided. If no file is given, 
the standard input is assumed. Options are: 


e Do not erase screen before initiating display. 


rn Display GPS region n, n between 1 and 25 
inclusive. 


u Display the entire GPS universe. 


SEE ALSO 
ged(1G), graphics(1G). 
gps(4) in the UNIX System Programmer Reference Manual. 


Ne J 


aa 


a 


: gor 
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NAME 


ged — graphical editor 


SYNOPSIS 


ged [—euRrn] [GPS file ...] 


DESCRIPTION : 


Ged is an interactive graphical editor used to display, construct, and 
edit GPS files on TEKTRONIX 4010 series display terminals. If GPS 
file(s) are given, ged reads them into an internal display buffer and 
displays the buffer. The GPS in the buffer can then be edited. If - 
is given as a file name, ged reads a GPS from the standard input. 


Ged accepts the following command line options: 
e Do not erase the screen before the initial display. 
rn Display region number n. 
u Display the entire GPS universe. 
R Restricted shell invoked on use of !. 


A GPS file is composed of instances of three graphical objects: 
lines, arc, and text. Arc and lines objects have a start point, or 
object-handle, followed by zero or more points, or point-handles. 
Text has only an object-handle. The objects are positioned within a 
Cartesian plane, or universe, having 64K (—32K to +32K) points, or 
universe-units, on each axis. The universe is divided into 25 equal 
sized areas called regions. Regions are arranged in five rows of 
five squares each, numbered 1 to 25 from the lower left of the 
universe to the upper right. 


Ged maps rectangular areas, called windows, from the universe 
onto the display screen. Windows allow the user to view pictures 
from different locations and at different magnifications. The 
universe-window is the window with minimum magnification, i.e., the 
window that views the entire universe. The home-window is the 
window that completely displays the contents of the display buffer. 


COMMANDS 
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Ged commands are entered in stages . Typically each stage ends 
with a <er> (return). Prior to the final <cr> the command may be 
aborted by typing rubout. The input of a stage may be edited dur- 
ing the stage using the erase and kill characters of the calling shell. 
The prompt * indicates that ged is waiting at stage 1. 


Each command consists of a subset of the following stages: 
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1. Command line 


2. Text 
3. Points 
4. Pivot 


A command line consists of a command name fol- 
lowed by argumenti(s) followed by a <er>. A com- 
mand name is a single character. Command argu- 
ments are either option(s) or a file-name. Options are 
indicated by a leading -. 


Text is a sequence of characters terminated by an 
unescaped <cr>. (120 lines of text maximum.) 


Points is a sequence of one or more screen locations 
(maximum of 30) indicated either by the terminal 
crosshairs or by name. The prompt for entering points 
is the appearance of the crosshairs. When the 
crosshairs are visible, typing: 


sp (space) enters the current location as a point. 
The point is identified with a number. 


$n enters the previous point numbered n. 


>x labels the last point entered with the upper case 
letter x. 


$x enters the point labeled x. 


establishes the previous points as the current 
points. At the start of a command the previous 
points are those locations given with the previ- 
ous command. 


= echoes the current points. 


_$.n enters the point numbered n from the previous 


points. 
# | erases the last point entered. 
@ ___ erases all of the points entered. 


“The pivot is a single location, entered by typing <er> 


or by using the $ operator, and indicated with a *. 


5. Destination 


The destination is a single location entered by typing 
<cr> or by using $. 


COMMAND SUMMARY 
In the summary, characters typed by the user are printed in bold. 
Command stages are printed in italics. Arguments surrounded by 
brackets “[]" are optional. Parentheses “()” surrounding arguments 
separated by ‘or’ means that one of the arguments must be given. 
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Construct commands: 


Arc 

Box 
Circle 
Hardware 
Lines 
Text 


Edit commands: 
Delete 


Edit 


Kopy 
Move . 
Rotate 
Scale 


View commands: 
coordinates 


erase 
new-display 


[-echo,style,weight] points 
[-echo,style,weight] points 
[—echo, style, weight] points 
[-echo] text points 

[—echo, style, weight] points 


[—angle,echo, height, mid-point, right- 
point,text, weight] text points 


— (universe or view) or points ) 


( 
{-angle,echo,height, style, weight] ( — (universe or 
view) or points ) 


[-echo,points,x] points pivot destination 
[~echo, points,x] points pivot destination 
[-angle,echo,kopy,x] points pivot destination 
[-echo,factor, kopy,x] points pivot destination 


points 


object-handles _( — (universe or view) or points ) 


point-handles 
view 


X 
zoom 


Other commands: 
quit or Quit 
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( — (labelled-points or universe or view) or 
points ) 


( — (home or universe or region) or [—x] 
pivot destination ) 


[—view] points 
[—out] points 
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read [—angle, echo, height,mid- -point, non yee 
point, text, weight ; 
file-name [destination] a 


set [-angle,echo,factor, height, kopy,mid-point, points, 
right-point, style, text, weight, x] 

write file-name 

command 

? 


Options: 

Options specify parameters used to construct, edit, and view graphi- 
cal objects. If a parameter used by a command is not specifed as 
an option, the default value for the parameter will be used (see set 
below). The format of command options is: 

—option{[,option | 
where option is keyletter[value]. Flags take on the values of true or 
false indicated by + and —- respectively. If no va/ue is given with a 
flag, true is assumed. 


Object options: | oat 
anglen Angle of n degrees. eg 
echo When true, echo additions to the display buffer. 
factorn Scale factor is n percent. 
heightn Height of text is n universe-units (0<n< 1280). 
kopy | _ When true, copy rather than move. 


mid-point When true, mid-point is used to locate text string. 


points ' When true, operate on points otherwise operate 
on objects. 
right-point When true, right-point is used to locate text 
string. 
styletype Line style set to one of following types: 
so solid 
da dashed 
dd dot-dashed ~ 
do _ dotted 
Id long-dashed 
fe ~ 
text When false, text strings are outlined rather thar 
drawn. S/ 
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weighttype Sets line weight to one of following types: 


Area options: 


n Narrow 
m medium 
b bold 

home Reference the home-window. 

out Reduce magnification. 

regionn Reference region n. 

universe Reference the universe-window. 

view Reference those objects currently in view. 

x Indicate the center of the referenced area. 


COMMAND DESCRIPTIONS 
Construct commands: 
Arc and Lines 


behave similarly. Each consists of a command line followed 
by points . The first point entered is the object-handle. Suc- 
cessive points are point-handles. Lines connect the handles 
in numerical order. Arc fits a curve to the handles (currently a 
maximum of 3 points will be fit with a circular arc; splines will 
be added in a later version). 


Box and Circle 


are special cases of Lines and Arc, respectively. Box gen- 
erates a rectangle with sides parallel to the universe axes. A 
diagonal of the rectangle would connect the first point entered 
with the last point. The first point is the object-handle. Point- 
handles are created at each of the vertices. Circle generates 
a circular arc centered about the point numbered zero and 
passing through the last point. The circle’s object-handle coin- 
cides with the last point. A point-handle is generated 180 
degrees around the circle from the object-handle. 


Text and Hardware 
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generate text objects. Each consists of a command line , text 
and points . Text is a sequence of characters delimited by 
<cr>. Multiple lines of text may be entered by preceding a cr 
with a backslash (i.e., \cr). The Text command creates 
software generated characters. Each line of software text is 
treated as a separate text object. The first point entered is 
the object-handle for the first line of text. The Hardware com- 
mand sends the characters in text uninterpreted to the termi- 
nal. 
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Edit commands: jor 
Edit commands operate on portions of the display buffer called | | 
defined areas. A defined area is referenced either with an area 
option or interactively. If an area option is not given, the perimeter 
of the defined area is indicated by points. If no point is entered, a 
smail defined area is built around the location of the <cr>. This is 
useful to reference a single point. If only one point is entered, the 
location of the <ecr> is taken in conjunction with the point to indi- 
cate a diagonal of a rectangle. A defined area referenced by points 
will be outlined with dotted lines. 


Delete 
removes all objects whose object-handle lies within a defined 
area. The universe option removes all objects and erases the 
screen. 


Edit modifies the parameters of the objects within a defined area. 
Parameters that can be edited are: 
angle angle of text 
height height of text 
style — style of lines and arc 
weight weight of lines, arc, and text. 


Kopy (or Move) a 
copies (or moves) object- and/or point-handles within a defined “-” 
area by the displacement from the pivot to the destination. 


Rotate | 
rotates objects within a defined area around the pivot. If the 
kopy flag is true then the objects are copied rather than 
moved. 


Scale 
For objects whose object handles are within a defined area, 
point displacements from the pivot are scaled by factor per- 
cent. If the kopy flag is true then the objects are copied rather 
than moved. 


View commands: 
coordinates 
prints the location of point(s) in universe- and screen-units. 


erase 
clears the screen (but not the display buffer). 
new-display | eer 
erases the screen then displays the display buffer. \ j 
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object-handles (or point-handles) 

( labels object-handles (and/or point-handles) that lie within the 
| defined area with O (or P). Point-handles identifies labeled 
points when the labelled-points flag is true. 


view moves the window so that the universe point corresponding to 
the pivot coincides with the screen point corresponding to the 
destination. Options for home, universe, and region display 
particular windows in the universe. 


Xx indicates the center of a defined area. Option view indicates 
the center of the screen. 


zoom 
decreases (zoom out) or increases the magnification of the 
viewing window based on the defined area. For increased 
magnification, the window is set to circumscribe the defined 
area. For a decrease in magnification the current window is 
inscribed within the defined area. 


Other commands: 


quit or Quit 
— exit from ged. Quit responds with ? if the display buffer has 
( not been written since the last modification. 


read inputs the contents of a file. If the file contains a GPS it is 
read directly. If the file contains text it is converted into text 
object(s). The first line of a text file begins at destination. 


set when given option(s) resets default parameters, otherwise it 
prints current default values. 


write outputs the contents of the display buffer to a file. 
! escapes ged to execute a UNIX system command. 
? lists ged commands. 


SEE ALSO 
gdev(1G), graphics(1G), sh(1). 
gps(4) in the Sys5 UNIX Programmer Manual. 


An Introduction to the Graphical Editor in the Sys5 UNIX Graphics 
Guide . 


WARNING 
See Appendix A of the TEKTRONIX 4014 Computer Display Terminal 
User's Manual for the proper terminal strap options. | 
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NAME os 
get — get a version of an SCCS file i 


SYNOPSIS 
get [-rSiD] [-ccutoff] [-ilist] [—xlist] [-wstring] [—aseq-no.] [—k] 
(-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [+t] file ... 

DESCRIPTION 
Get generates an ASCII text file from each named SCCS file accord- 
ing to the specifications given by its keyletter arguments, which 
begin with -. The arguments may be specified in any order, but all 
keyletter arguments apply to all named SCCS files. If a directory is 
named, get behaves as though each file in the directory were speci- 
fied as a named file, except that non-SCCS files (last component of 
the path name does not begin with s. ) and unreadable files are 
silently ignored. If a name of —- is given, the standard input is read; 
each line of the standard input is taken to be the name of an SCCS 
file to be processed. Again, non-SCCs files and unreadable files are 
silently ignored. 


The generated text is normally written into a file called the g-file 
whose name is derived from the SCCS file name by simply removing 
the leading s. ; (see also FILES, below). 


Each of the keyletter arguments is explained below as though only 
one SCCS file is to be processed, but the effects of any keyletter ~- 
argument applies independently to each named file. 


-rS!D The S CCS /D entification string (SID) of the version 
(delta) of an SCCS file to be retrieved. Table 1 below 
shows, for the most useful cases, what version of an 
SCCS file is retrieved (as well as the SID of the version to 
be eventually created by delta (1) if the -e keyletter is 
also used), as a function of the SID specified. 


/ 
Eo 


—ccutoff Cutoff date-time, in the form: 
YY(MM[DD[HH[MM[SS]]}]]] 


No changes (deltas) to the SCCS file which were created 
after the specified cutoff date-time are included in the 
generated ASCil text file. Units omitted from the date- 
time default to their maximum possible values; that is, 
~—C7502 is equivalent to -c750228235959 . Any number 
of non-numeric characters may separate the various 2- 
digit pieces of the cutoff date-time. This feature allows 
one to specify a cutoff date in the form: "-c77/2/2 ,—~ 
9:22:25". Note that this implies that one may use the! 
%E% and %U% identification keywords (see below) for ae 
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nested gets within, say the input to a send (1C) com- 
mand: 


“Iget "_C%E% %U%" s_file 


Indicates that the gef is for the purpose of editing or 
making a change (delta) to the SCCS file via a subse- 
quent use of de/ta (7). Tne -e keyletter used in a get for 
a particular version (SID) of the SCCS file prevents 
further gets for editing on the same SID until delta is 
executed or the j (joint edit) flag is set in the SCCS file 
(see admin (1)). Concurrent use of get —-e for different 
SIDs is always allowed. 


If the g-file generated by get with an -e keyletter is 
accidentally ruined in the process of editing it, it may be 
regenerated by re-executing the get command with the 
-k keyletter in place of the —e keyletter. 


SCCS file protection specified via the ceiling, floor, and 
authorized user list stored in the SCCS file (see admin 
(1)) are enforced when the -e keyletter is used. 


Used with the -e keyletter to indicate that the new delta 
should have an SID in a new branch as shown in 
Table 1. This keyletter is ignored if the b flag is not 
present in the file (see admin (71)) or if the retrieved 
delta is not a leaf delta . (A leaf delta is one that has no 
successors on the SCCS file tree.) 

Note: A branch delta may always be created from a 
non-leaf delta . 


A list of deltas to be included (forced to be applied) in . 
the creation of the generated file. The /ist has the follow- 
ing syntax: 


<list> = <range> <list> , <range> 
<range> ::= SID SID — SID 


SID, the SCCS Identification of a delta, may be in any 
form shown in the “SID Specified” column of Table 1. 
Partial SIDS are interpreted as shown in the “SID 
Retrieved’ column of Table 1. 


A list of deltas to be excluded (forced not to be applied) 
in the creation of the generated file. See the -i keyletter 
for the list format. 
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—S 


—m 


“g 


-w string 
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Suppresses replacement of identification keywords (see 
below) in the retrieved text by their value. The —k 
keyletter is implied by the -e keyletter. 


Causes a delta summary to be written into an /-file . If 
—Ip is used then an /-file is not created; the delta sum- 
mary is written on the standard output instead. See 
FILES for the format of the /-file . 


Causes the text retrieved from the’SCCS file to be written 
on the standard output. No g-file is created. All output 
which normally goes to the standard output goes to file 
descriptor 2 instead, unless the —s keyletter is used, in 
which case it disappears. 


Suppresses all output normally written on the standard 
output. However, fatal error messages (which always go 
to file descriptor 2) remain unaffected. 


Causes each text line retrieved from the SCCS file to be 
preceded by the SID of the delta that inserted the text 
line in the SCCS file. The format is: SID, followed by a 
horizontal tab, followed by the text line. 


Causes each generated text line to be preceded with the 
%M% identification keyword value (see below). The for- 
mat is: %M% value, followed by a horizontal tab, fol- 
lowed by the text line. When both the -m and —-n 
keyletters are used, the format is: %M% value, followed 
by a horizontal tab, followed by the —m keyletter gen- 
erated format. 


Suppresses the actual retrieval of text from the SCCS 
file. It is primarily used to generate an /-file , or to verify 
the existence of a particular SID. 


Used to access the most recently created (‘top’) delta in 
a given release (e.g., -r1 ), or release and level (e.g., 
—r1.2 ). 


Substitute — string for all occurrences of 
@(#)get.1 6.2 when geting the file. 


The delta sequence number of the SCCS file delta (ver- 
sion) to be retrieved (see sccsfile(5)). This keyletter is 
used by the comb (1) command; it is not a generally 
useful keyletter, and users should not use it. If both the 
-r and -a keyletters are specified, the -a keyletter is 
used. Care should be taken when using the —a keyletter 
in conjunction with the -e keyletter, as the SID of the 
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delta to be created may not be what one expects. The 
~—r keyletter can be used with the —a and —e keyletters to 
control the naming of the SID of the delta to be created. 


For each file processed, get responds (on the standard output) with 
the SID being accessed and with the number of lines retrieved from 
the SCCS file. 


If the —e keyletter is used, the SID of the delta to be made appears 
after the SID accessed and before the number of lines generated. If 
there is more than one named file or if a directory or standard input 
is named, each file name is printed (preceded by a new-line) before 
it is processed. If the -i keyletter is used included deltas are listed 
following the notation “Included”; if the -x keyletter is used, 
excluded deltas are listed following the notation “Excluded’. 


TABLE 1. Determination of SCCS Identification String 


bi! Keyletter Other SID SID of Delta 
Specified _Usedt_ _—=_— Conditions _—Retrieved __to be Created - 
none no R __R defaults ton mR mR.1 mL oma. (mL ~" a 7 
none:: yes R defaults tomR mR.mL — mA.mL. ¢.mL.(mB ~ r Aa 
R no R>mR omAm_ RA 
’R no R= mR mR.mL —mR.(mL +1) a 
“R yes R>mR mR.mbL mR.mL.(m — 4 
R yes R= mR mR.mL mR.mL.(mB ~ 1).1 
R< mR an 
R R does me — hR.mL** hR.mL.(mB+1).1 
Trunk succ.# 
R - in release > R R.mL R.mL.(mB + 1).1 
and R exists 
R.L | no No trunk succ. — RL R.(L+1) 
R.L yes | No trunk succ. R.L R.L.(mB + 1).1 
Trunk 
R.L = : panes 5. AL R.L.(mB+1).1 
R.L.B no No branch succ. R.L.B.mS = R.L.B.(mS +1) 
R.L.B yes ~Nobranch succ. RALBmS R.L.(mB+1).1 
R.L.B.S no No branch succ. R.L.B.S R.L.B.(S +1) 
R.L.B.S yes No branch succ. R.L.B.S R.L.(mB +1).1 
R.L.B.S _ Branch succ. R.L.B.S R.L.(mB + 1).1 
7  *R”, “L", “B”, and “S” are the ‘release’, “level”, “branch”, and 
“sequence” components of the SID, respectively; “m” means 
“maximum”. Thus, for example, “R.mL” means “the maximum 
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level number within release R"; “R.L.(mB+1).1° means “the --. 
first Sequence number on the new branch (i.e., maximum— 
branch number plus one) of level L within release R”. Note that ~ 


if the SID specified is of the form “R.L’, “R.L.B”’, or “R.L.B.S’, 
each of the specified components must exist. 

“HR” is the highest existing release that is lower than the speci- 
fied, nonexistent , release R. 

This is used to force creation of the first delta in a new release. 
Successor. 

The —b keyletter is effective only if the b flag (See admin (7)) Is 
present in the file. An entry of ~ means “irrelevant”. 

This case applies if the d (default SID) flag is not present in the 
file. If the d flag is present in the file, then the SID obtained 
from the d flag is interpreted as if it had been specified on the 
command line. Thus, one of the other cases in this table 
applies. 


IDENTIFICATION KEYWORDS 
Identifying information is inserted into the text retrieved from the 
SCCS file by replacing identification keywords with their value wher- 
ever they occur. The following keywords may be used in the text 
stored in an SCCS file: 


Keyword Value 
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%~M% 


%el% 


%R% 
%L% 
% ° B % Qo 


%SY% 


%D% 
%H% 
%T% 
% 3° E % 3° 
%G% 
%WwU% 
WY % 


YoF% 
%P% 
%Q% 


Module name: either the value of the m flag in the file 


(see admin (1)), or if absent, the name of the SCCS file 
with the leading s. removed. 

SCCS identification (SID) (%R%.%L%.%B%.%S%) of the 
retrieved text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY’MM/DD). 

Current date (MM/DD/YY). 

Current time (HH:MM:SS). 

Date newest applied delta was created (YY/.MM/DD). 
Date newest applied delta was created (MM/DD/YY). 
Time newest applied delta was created (HH:MM:SS). 
Module type: value of the t flag in the SCCS file 
admin (1)). 

SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see admin (7)). 


(see 
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%C% Current line number. This keyword is intended for identi- 
fying messages output by the program such as “this 
should not have happened” type errors. It is not 
intended to be used on every line to provide sequence 
numbers. 

%WL% The 4-character string @(#) recognizable by what (7). 

%W% A shorthand notation for constructing what (7) strings for 


UNIX system program files. 
WW = %Ll%%M%< horizontal-tab > %l% 
YA Another shorthand notation for constructing what (1) 


strings for non-UNIX system program files. 
WA = MLV % ~YM% VIVVL%o 


Several auxiliary files may be created by get. These files are known 
generically as the g-file , I-file , p-file , and z-file . The ‘etter before 
the hyphen is called the tag. An auxiliary file name is formed from 
the SCCS file name: the last component of all SCCS file names must 
be of the form s.module-name, the auxiliary files are named by 
replacing the leading s with the tag. The g-file is an exception to 
this scheme: the g-file is named by removing the s. prefix. For 
example, s.xyz.c , the auxiliary file names would be xyz.c , l.xyz.c , 
p.xyz.c , and z.xyz.c , respectively. 


The g-file , which contains the generated text, is created in the 
current directory (unless the -p keyletter is used). A g-file is 
created in all cases, whether or not any lines of text were generated 
by the get. It is owned by the real user. If the -k keyletter is used 
or implied its mode is 644; otherwise its mode is 444. Only the real 
user need have write permission in the current directory. 


The /-file contains a table showing which deltas were applied in gen- 
erating the retrieved text. The /-file is created in the current direc- 
tory if the -I keyletter is used; its mode ts 444 and it is owned by the 
real user. Only the real user need have write permission in the 
current directory. 


Lines in the /-file have the following format: 


a. A blank character if the delta was applied; 
* otherwise. 
b. A blank character if the delta was applied or was 


not applied and ignored; 
* if the delta was not applied and was not ignored. 
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C: A code indicating a “special” reason why the delta _- 


was Or was not applied: 

“Tl: Included. 

“X': Excluded. 

“C": Cut off (by a —c keyletter). 
d. Blank. 
e. SCCS identification (SID). 
f Tab character. 
g Date and time (in the form YY'MM/DD HH:MM:SS) of 
creation. 
Biank. | 
I. Login name of person who created delta. 


ad 


The comments and MR data follow on subsequent lines. 
indented one horizontal tab character. A blank line ter- 
minates each entry. 


The p-file is used to pass information resulting from a get with an 
-~e keyletter along to delta . Its contents are also used to prevent a 
subsequent execution of get with an -e keyletter for the same SID 
until de/ta is executed or the joint edit flag, j , (see admin (1)) is set 
in the SCCS file. The p-file is created in the directory containing the 
SCCS file and the effective user must have write permission in that 
directory. Its mode is 644 and it is owned by the effective user. 
The format of the p-file is: the gotten SID, followed by a blank, fol- 
lowed by the SID that the new delta will have when it is made, fol- 
lowed by a blank, followed by the login name of the real user, fol- 
lowed by a blank, followed by the date-time the get was executed, 
followed by a blank and the -i keyletter argument if it was present, 
followed by a blank and the -x keyletter argument if it was present, 
followed by a new-line. There can be an arbitrary number of lines in 
the p-file at any time; no two lines can have the same new delta 
SID. 


The z-file serves as a lock-out mechanism against simultaneous 
updates. Its contents are the binary (2 bytes) process ID of the 
command (i.e., get) that created it. The z-file is created in the 
directory containing the SCCS file for the duration of get. The same 
protection restrictions as those for the p-file apply for the z-file . The 
z-file is created mode 444. 


SEE ALSO 
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admin(1), delta(1), help(1), prs(1), what(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System in the Sys5 UNIX Support Tools 
Guide . 
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- DIAGNOSTICS 
( Use help (1) for explanations. 


BUGS 
If the effective user has write permission (either explicitly or impli- 
citly) in the directory containing the SCCS files, but the real user 
does not, then only one file may be named when the —e keyletter is 
used. 
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NAME 


getopt — parse command options \ 
SYNOPSIS 
set — *getopt optstring $*- 
DESCRIPTION 
Getopt is used to break up options in command lines for easy pars- 
ing by shell procedures and to check for legal options. Optstring is 
a string of recognized option letters (see getopt(3C)); if a letter is 
followed by a colon, the option is expected to have an argument 
which may or may not be separated from it by white space. The 
special option — is used to delimit the end of the options. If it is 
used explicitly, getopt will recognize it; otherwise, gefopt will gen- 
erate it; in either case, getopt will place it at the end of the options. 
The positional parameters ($1 $2 ...) of the shell are reset so that 
each option is preceded by a — and is in its own positional parame- 
ter; each option argument is also parsed into its own positional 
parameter. 
EXAMPLE 
The following code fragment shows how one might process the 
arguments for a command that can take the options aorb, aswell 
as the option o , which requires an argument: —_ 
set — ‘getopt abo: $** 
if [ $2? '= 0] 
then 
echo $USAGE 
exit 2 
fi 
for i in $« 
do 
case $i in 
—a | -b) FLAG=$i; shift;; 
—O) OARG= $2; shift 2;; 
—) shift; break;; 
esac 
done 
This code will accept any of the following as equivalent: 
cmd —aoarg file file 
cmd —a —0o arg file file 
cmd —oarg —a file file 
cmd —a —oarg — file file 
SEE ALSO 
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sh(1), getopt(3C). 
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-. DIAGNOSTICS 
( Getopt prints an error message on the standard error when it 
" encounters an option letter not included in optstring . 
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graph — draw a graph 


SYNOPSIS 


graph [ options | 


DESCRIPTION 


Graph with no options takes pairs of numbers from the standard 
input as abscissas and ordinates of a graph. Successive points are 
connected by straight lines. The graph is encoded on the standard 
output for display by the tp/ot (7G) filters. 


If the coordinates of a point are followed by a non-numeric string, 
that string is printed as a label beginning on the point. Labels may 
be surrounded with quotes ", in which case they may be empty or 
contain blanks and numbers; labels never contain new-lines. 


The following options are recognized, each as a separate argument: 


—a 


-S 


-x [1] 


~y [lt] 
—h 
—W 
-F 
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Supply abscissas automatically (they are missing from 
the input); spacing is given by the next argument (default 
1). A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by -x 
). 

Break (disconnect) the graph after each label in the 
input. 

Character string given by next argument is default label 
for each point. 

Next argument is grid style, 0 no grid, 1 frame with ticks, 
2 full grid (default). 

Next argument is label for graph. 

Next argument is mode (style) of connecting lines: 0 
disconnected, 1 connected (default). Some devices give 
distinguishable line styles for other small integers (e.g., 
the TEKTRONIX 4014: 2=dotted, 3=dash-dot, 4=short- 
dash, 5=long-dash). 

Save screen, do not erase before plotting. 

If | is present, x axis is logarithmic. Next 1 (or 2) argu- 
ments are lower (and upper) x limits. Third argument, if 
present, is grid spacing on x axis. Normally these quan- 
tities are determined automatically. 

Similarly for y . 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before 
plotting. | 
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hae —u Similarly to move up before plotting. 
( —t Transpose horizontal and vertical axes. (Option —x now 
applies to the vertical axis.) 
A legend indicating grid range is produced with a grid unless the —-s 
option is present. If a specified lower limit exceeds the upper limit, 
the axis is reversed. | 


SEE ALSO 
graphics(1G), spline(1G), tplot(1G). 
BUGS 


Graph stores all points internally and drops those for which there is 
no room. 


Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 


May 23,1985 Page 2 


GRAPHICS(1G) UNIX Sys5 GRAPHICS(1G) 


NAME 


graphics — access graphical and numerical commands 


SYNOPSIS 


graphics [ -r | 


DESCRIPTION 


Graphics prefixes the path name /usr/bin/graf to the current $PATH 
value, changes the primary shell prompt to *, and executes a new 
shell. The directory /usr/bin/graf contains all of the Graphics sub- 
system commands. If the -r option is given, access to the graphical 
commands is created in a restricted environment; that is, $PATH is 
set to 
‘/usr/bin/graf:/rbin:/usr/ 

and the restricted shell, rsh , is invoked. To restore the environment 
that existed prior to issuing the graphics command, type EOT 
(control-d on most terminals). To logoff from the graphics environ- 
ment, type quit. 


The command line format for a command in graphics is command 
name followed by argument(s). An argument may be a file name or 
an option string. A file name is the name of any UNIX system file 
except those beginning with —. The file name — is the name for the 


standard input. An option string consists of — followed by one or | 
more option(s). An option consists of a keyletter possibly followed ~ 


by a value. Options may be separated by commas. 
The graphical commands have been partitioned into four groups. 


Commands that manipulate and plot numerical data; see 
stat (1G). 


Commands that generate tables of contents; see toc (7G). 


Commands that interact with graphical devices; see gdev 
(1G) and ged (1G). 


A collection of graphical utility commands; see gutil (1G). 


A list of the graphics commands can be generated by typing whatis 
in the graphics environment. 


SEE ALSO 
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gdev(1G), ged(1G), gutil(1G), stat(1G), toc(1G). 
gps(4) in the Sys5 UNIX Programmer Reference Manual. 


Sys5 UNIX Graphics Guide . 


May 23, 1985 


GREEK(1) UNIX Sys5 GREEK(1) 


_ NAME 
( | greek — select terminal filter 
~ SYNOPSIS 
c-eek [ —T terminal | 
DESCRIPTION | 
Greek is a filter that reinterprets the extended character set, as well 
as the reverse and haif-line motions, of a 128-character TELETYPE * 
Model 37 terminal (which is the nroff (7) default terminal) for certain 
other terminals. Special characters are simulated by overstriking, if 
necessary and possible. If the argument is omitted, greek attempts 
to use the environment variable $STERM (see environ (5)). The fol- 
lowing terminal s are recognized currently: 
300 DAS! 300. 
300-12 DASI 300 in 12-pitch. 
300s DASI 300s. 
300s-12 DAS! 300s in 12-pitch. 
450 DASI 450. 
450-12 DASI 450 in 12-pitch. 
1620 Diablo 1620 (alias DAS! 450). 
1620-12 Diablo 1620 (alias DASI 450) in 12-pitch. 
-_ 2621 Hewlett-Packard 2621, 2640, and 2645. 
( 2640 Hewlett-Packard 2621, 2640, and 2645. 
2645 Hewlett-Packard 2621, 2640, and 2645. 
4014 TEKTRONIX 4014. 
hp Hewlett-Packard 2621, 2640, and 2645. 
tek TEKTRONIX 4014. 
FILES 
/usr/bin/300 
/usr/bin/300s 
/usr/bin/4Q14 
/usr/bin/450 
/usr/din/hp 
SEE ALSO 


300(1), 4014(1), 450(1), eqn(1), hp(1), mm(1), nroff(1), tplot(1G). 
environ(5), term(5) in the Sys5 UNIX Programmer Reference 
Manual. 

Sys5 UNix Documenter’s Workbench Software Introduction and 
Reference Manual. 
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NAME 


grep, egrep, fgrep — search a file for a pattern 


SYNOPSIS 


grep [ options | expression [ files ] 
egrep [ options | [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 


DESCRIPTION 


Page 1 


Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is 
copied to the standard output. Grep patterns are limited regular 
expression s in the style of ed (7); it uses a compact non- 
deterministic algorithm. Egrep patterns are full regular expression 
s; it uses a fast deterministic algorithm that sometimes needs 
exponential space. Fgrep patterns are fixed strings ; it is fast and 
compact. The following options are recognized: 


-V All lines but those matching are printed. 

—X (Exact) only lines matched in their entirety are printed ee 
only). 

—c Only acount of matching lines is printed. 

—I Ignore upper/lower case distinction during comparisons. 

—I Only the names of files with matching ue are listed (once), 
separated by new-lines. 

—n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 
numbers by context. 

—S The error messages produced for nonexistent or unreadable 
files are suppressed (grep only). 

—e expression 
Same as a simple expression argument, but useful when the 
expression begins with a — (does not work with grep ). 

-f file The regular expression (egrep) or strings list (fgrep) is 
taken from the file . 


In all cases, the file name is output if there is more than one input 
file. Care should be taken when using the characters $,*,[,°, |, 
(,), and \ in expression , because they are also meaningful to the 
shell. It is safest to enclose the entire expression argument in sin- 
gle quotes’... ’. 


Fgrep searches for lines that contain one of the strings separated 
by new-lines. 
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Egrep accepts regular expressions as in ed (7), except for \( and \) 
, with the addition of: 


1. A regular expression followed by + matches one or more 
occurrences of the regular expression. 

2. A regular expression followed by ? matches O or 1 
occurrences of the regular expression. 

3. Two regular expressions separated by | or by a new-line 
match strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for 
grouping. 


The order of precedence of operators is [] , then * ?+ , then con- 
catenation, then | and new-line. | 


SEE ALSO 
ed(1), sed(1), sh(1). 


DIAGNOSTICS 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax 
errors or inaccessible files (even if matches were found). 

BUGS 
Ideally there should be only one grep , but we do not know a single 
algorithm that spans a wide enough range of space-time tradeoffs. 
Lines are limited to BUFSIZ characters; longer lines are truncated. 
(BUFSIZ is defined in /usr/include/stdio.h .) 
Egrep does not recognize ranges, such as [a—-z] , in character 
classes. 
If there is a line with embedded nulls, grep will only match up to the 
first null; if it matches, it will print the entire line. 
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NAME 


gutil — graphical utilities = ) 


SYNOPSIS 


command-name [options] [files] 


DESCRIPTION 
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Below is a list of miscellaneous device independent utility com- 
mands found in /usr/bin/graf . If no files are given, input is from the 
standard input. All output is to the standard output. Graphical data 
is stored in GPS format; see gps (4). 


bel — send bel character to terminal 


cvrtopt [-=sstring fstring istring tstring | [args ] — options con- 
verter 
Cvrtopt reformats args (usually the command line argu- 
“ments of a calling shell procedure) to facilitate process- 
ing by shell procedures. An arg is either a file name (a 
string not beginning with a -, or a — by itself) or an option 
string (a string of options beginning with a —). Output is 
of the form: 
—option -option. . . file name(s) joe 
All options appear singularly and preceding any file” 
names. Options that take values (e.g., -r1.1) or are 
two-letters long must be described through options to 
cvrtopt. 


xs 


Cvrtopt is usually used with set in the following manner 
as the first line of a shell procedure: 

set — scvrtopt =[" options "] $@*" 
Options to cvrtopt are: 


sstring String accepts string values. 


fstring String accepts floating point numbers as 
values. 


istring String accepts integers as values. 


tstring String is a two-letter option name that takes 
no value. 


String is a one- or two-letter option name. 


gd [GPS files }| —GPS dump 
Gd prints a human readable listing of GPS. 
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gtop 


pd 


ptog 


quit 
remcom 


whatis 


yoo 


SEE ALSO 


UNIX Sys5 GUTIL(1G) 


[-rnu ] [GPS files ] — GPS to plot(4) filter 

Gtop transforms a GPS into plot(4) commands display- 
able by plot filters. GPS objects are translated if they fall 
within the window that circumscribes the first file unless 
an option is given. 

Options: 


rn translate objects in GPS region n. 
u translate all objects in the GPS universe. 


[ plot(5) files | — plot(4) dump 
Pd prints a human readable listing of plot(4) format 
graphical commands. 


[ plot(5) files | — plot(4) to GPS filter 
Ptog transforms plot(4) commands into a GPS. 


— terminate session 


[ files ] — remove comments 

Remcom copies its input to its output with comments 
removed. Comments are as defined in C (i.e., /* com- 
ment */). 


[-o ] [ names ] — brief on-line documentation 

Whatis prints a brief description of each name given. lf 
no name is given, then the current list of description 
names is printed. The command whatis \* prints out 
every description. 

Option: 


te) just print command o ptions 


file — pipe fitting 

Yoo is a piping primitive that deposits the output of a 
pipeline into a file used in the pipeline. Note that, without 
yoo, this is not usually successful as it causes a read 
and write on the same file simultaneously. 


graphics(1G). 
gps(4), plot(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 

head — give first few lines of a stream 
SYNOPSIS 

/usr/pix/head [ —count ] [ file... ] 
DESCRIPTION | 


This filter gives the first count lines of each of the specified files, or 
of the standard input. If count is omitted it defaults to 10. 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
tail(1) 
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NAME 
help — ask for help 


~ SYNOPSIS 


help [args] 


DESCRIPTION | 
Help finds information to explain a message from a command or 
explain the use of a command. Zero or more arguments may be 
supplied. If no arguments are given, help will prompt for one. 


The arguments may be either message numbers (which normally 
appear in parentheses following messages) or command names, of 
one of the following types: 


type 1 Begins with non-numerics, ends in numerics. 
The non-numeric prefix is usually an abbrevi- 
ation for the program or set of routines which 
produced the message (e.g., ge6, for mes- 
sage 6 from the get command). 


type 2 Does not contain numerics (as a command, 
such as get ) 


type 3 Is all numeric (e.g., 212) 


The response of the program will be the explanatory information 
related to the argument, if there is any. 


When all else fails, try “help stuck”. 


FILES 
/usr/lib/help directory containing files of message 
text. 


/usr/lib/help/helploc file containing locations of help files not 
. in /usr/lib/help. 


DIAGNOSTICS 
Use help (1) for explanations. 


Page 1 May 16, 1986 


HP(1) UNIX Sys5 HP(71) 


NAME | 
hp — handle special functions of HP 2640 and 2621-series terminals < ~ 
‘ 
SYNOPSIS ae, 
hp [-e ] [-m ] 


DESCRIPTION | 
Hp supports special functions of the Hewlett-Packard 2640 series of 
terminals, with the primary purpose of producing accurate represen- 
tations of most nroff output. A typical use is: 


nroff —h files ... | hp 


Regardless of the hardware options on your terminal, Ap tries to do 
sensible things with underlining and reverse line-feeds. If the termi- 
nal has the “display enhancements” feature, subscripts and super- 
scripts can be indicated in distinct ways. If it has the 
“mathematical-symbol’” feature, Greek and other special characters 
can be displayed. 


The flags are as follows: 

-e lt is assumed that your terminal has the “display enhance- 
ments” feature, and so maximal use is made of the added 
display modes. Overstruck characters are presented in the 
Underline mode. Superscripts are shown in Half-bright 
mode, and subscripts in Half-bright, Underlined mode. If | 
this flag is omitted, ho assumes that your terminal lacks the ~~~ 
“display enhancements” feature. In this case, all overstruck 
characters, subscripts, and superscripts are displayed in 
Inverse Video mode, i.e., dark-on-light, rather than the usual 
light-on-dark. 

—m Requests minimization of output by removal of new-lines. 

Any contiguous sequence of 3 or more new-lines is con- 
verted into a sequence of only 2 new-lines; i.e., any number 
of successive blank lines produces only a single blank out- 
put line. This allows you to retain more actual text on the 
screen. 


With regard to Greek and other special characters, hp provides the 
same set as does 300 (1), except that “not” is approximated by a 
right arrow, and only the top half of the integral sign is shown. The 
display is adequate for examining output from neqn . 


DIAGNOSTICS 

“line too long” if the representation of a line exceeds 1,024 charac- 

ters. 

The exit codes are 0 for normal termination, 2 for all errors. wer 
SEE ALSO ‘of 


300(1), col(1), eqn(1), greek(1), nroff(1), tbi(1). 
Sys5 UNIX Documenter’s Workbench Software Introduction and 
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Reference Manual. 


An “overstriking sequence” is defined as a printing character fol- 
lowed by a backspace followed by another printing character. In 
such sequences, if either printing character is an underscore, the 
other printing character is shown underlined or in Inverse Video; oth- 
erwise, only the first printing character is shown (again, underlined 
or in Inverse Video). Nothing special is done if a backspace is adja- 
cent to an ASCII control character. Sequences of control characters 
(e.g., reverse line-feeds, backspaces) can make text “disappear”; in 
particular, tables generated by fb/ (7) that contain vertical lines will 
often be missing the lines of text that contain the “foot” of a vertical 
line, unless the input to Ap is piped through col (7). 

Although some terminals do provide numerical superscript charac- 
ters, no attempt is made to display them. 
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~~ NAME 


| hyphen — find hyphenated words 
SYNOPSIS 
hyphen [ files ] 
DESCRIPTION . 
Hyphen finds all the hyphenated words ending lines in files and 
prints them on the standard output. If no arguments are given, the 
standard input is used; thus, hyphen may be used as a filter. 
EXAMPLE 
The following will allow the proofreading of nroff hyphenation in 
textfile . 
mm textfile | hyphen 
SEE ALSO 
mm(1), nroff(1). 
BUGS 


Hyphen cannot cope with hyphenated italic (i.e., underlined) words; 
it will often miss them completely, or mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than 
spurious extra output. 
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NAME 
id — print user and group IDs and names 


SYNOPSIS 
id 

DESCRIPTION | 
Id writes a message on the standard output giving the user and 
group IDs and the corresponding names of the invoking process. If 
the effective and real IDs do not match, both are printed. 


SEE ALSO 
logname(1). 
getuid(2) in the Sys5 UNIX Programmer Reference Manual. 
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| NAME 
( ipcrm — remove a message queue, semaphore set or shared 
memory id 


SYNOPSIS 
ipcrm [ options | 


DESCRIPTION 
Ipcrm will remove one or more specified messages, semaphore or 
shared memory identifiers. The identifiers are specified by the fol- 
lowing options: 


—qmsqid removes the message queue identifier msqid from the 
system and destroys the message queue and data — 
structure associated with it. 


—m shmid removes the shared memory identifier shmid from the 
system. The shared memory segment and data struc- 
ture associated with it are destroyed after the last 
detach. 


-S semid removes the semaphore identifier semid from the sys- 
tem and destroys the set of semaphores and data 
structure associated with it. 


( , —Q msgkey removes the message queue identifier, created with 
. key msgkey, from the system and destroys the mes- 
sage queue and data structure associated with it. 


—-M shmkey removes the shared memory identifier, created with 
key shmkey, from the system. The shared memory 
segment and data structure associated with it are des- 
troyed after the last detach. 


-S semkey removes the semaphore identifier, created with key 
semkey, from the system and destroys the set of 
semaphores and data structure associated with it. 


The details of the removes are described in msgctl(2), shmctl(2), 
and semeti(2). The identifiers and keys may be found by using 
ipcs(1). 

SEE ALSO 
ipcs(1). 
msgcti(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), 
shmctl(2), shmget(2), shmop(2) in the Sys5 UNIX Programmer 


Reference Manual. 
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NAME | o* 
ipcs — report inter-process communication facilities status ee, 
SYNOPSIS 
ipcs [ options |] 
DESCRIPTION 


lpcs prints certain information about active inter-process communi- 
cation facilities. Without options , information is printed in short for- 
mat for message queues, shared memory, and semaphores that are 
currently active in the system. Otherwise, the information that is 
displayed is controlled by the following options : 


158.spOu » 

—q Print information about active message queues. 

-m _ Print information about active shared memory segments. 
~S Print information about active semaphores. 


If any of the options —q , —m , or —s are specified, information about 
only those indicated will be printed. If none of these three are speci- 
fied, information about all three will be printed. 


—-b Print biggest allowable size information. (Maximum number ~~ 
of bytes in messages on queue for message queues, size of . 
segments for shared memory, and number of semaphores ~ 
in each set for semaphores.) See below for meaning of 
columns in a listing. 

—C Print creator's login name and group name. See below. 

-o Print information on outstanding usage. (Number of mes- 
sages on queue and total number of bytes in messages on 
queue for message queues and number of processes 

attached to shared memory segments.) 

—p Print process number information. (Process ID of last pro- 

: cess to send a message and process ID of last process to 
receive a message on message queues and process ID of 
creating process and process ID of last process to attach or 
detach on shared memory segments) See below. 

—t Print time information. (Time of the last control operation 
that changed the access permissions for all facilities. Time 
of last msgsnd and last msgrcv on message queues, last 
shmat and last shmat on shared memory, last semop (2) 
on semaphores.) See below. 


—a Use all print options . (This is a shorthand notation for —b , 
—C ,-0,-p, and-t.) a 
-C corefile ice 


Use the file corefile in place of /dev/kmem . 
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—-N namelist 
The argument will be taken as the name of an alternate 
namelist (/unix is the default). 


The column headings and the meaning of the columns in an /pcs 
listing are given below; the letters in parentheses indicate the 
options that cause the corresponding heading to appear; all means 
that the heading always appears. Note that these options only 
determine what information is provided for each facility; they do not 
determine which facilities will be listed. 


a (all) Type of the facility: 
q message queue; 
m shared memory segment; 
S semaphore. 
ID (all) The identifier for the facility entry. 
KEY (all) The key used as an argument to msgget , semget 


, or shmget to create the facility entry. (Note: 
The key of a shared memory segment is changed 
to IPC_PRIVATE when the segment has been 
removed until all processes attached to the seg- 
ment detach it.) 


MODE (all) The facility access modes and flags: The mode 
consists of 11 characters that are interpreted as 
follows: 


The first two characters are: 

Rif a process is waiting on a msgrcv ; 

Sif a process is waiting on a msgsnd ; 

Dif the associated shared memory seg- 
ment has been removed. It. will 
disappear when the last process 
attached to the segment detaches tt; 

Cif the associated shared memory seg- 
ment is to be cleared when the first 
attach is executed; 

- if the corresponding special flag is 
not set. 


The next 9 characters are interpreted as three 
sets of three bits each. The first set refers to the 
owner's permissions; the next to permissions of 
others in the user-group of the facility entry; and 
the last to all others. Within each set, the first 
character indicates permission to read, the 
second character indicates permission to write or 
alter the facility entry, and the last character is 
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OWNER 
GROUP 


CREATOR 
CGROUP 


CBYTES 


QNUM 


QBYTES 


LSPID 


LRPID 


STIME 


RTIME 


CTIME 


NATTCH 


SEGSZ 


CPID 


LPID 


ATIME 


DTIME 


NSEMS 


(all) 
(all) 


(a,c) 
(a,c) 


(a,o) 
(a,o) 


(a,b) 


(a,p) 
(a,p) 
(a,t) 
(a,t) 
(at) 
(a,0) 
(a,b) 
(a,p) 
(a,p) 
(a,t) 
(a,t) 


(a,b) 


UNIX Sys5 IPCS(1) 


currently unused. 
The permissions are indicated as follows: 


r if read permission is granted: 

w_ if write permission is granted; 

aif alter permission is granted; 

— if the indicated permission is not 

granted. 

The login name of the owner of the facility entry. 
The group name of the group of the owner of the 
facility entry. | 
The login name of the creator of the facility entry. 
The group name of the group of the creator of the 
facility entry. 
The number of bytes in messages currently out- 
standing on the associated message queue. 
The number of messages currently outstanding on 
the associated message queue. 
The maximum number of bytes allowed in mes- 
sages outstanding on the associated message 
queue. 
The process ID of the last process to send a mes- 
sage to the associated queue. 
The process ID of the last process to receive a 
message from the associated queue. 
The time the last message was sent to the associ- 
ated queue. , 
The time the last message was received from the 
associated queue. 
The time when the associated entry was created 
or changed. 
The number of processes attached to the associ- 
ated shared memory segment. 
The size of the associated shared memory seg- 
ment. 
The process ID of the creator of the shared 
memory entry. 
The process ID of the last process to attach or 
detach the shared memory segment. 
The time the last attach was completed to the 
associated shared memory segment. 
The time the last detach was completed on the 
associated shared memory segment. 
The number of semaphores in the set associated 
with the semaphore entry. 
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in OTIME (a,t) The time the last semaphore operation was com- 
7. pleted on the set associated with the semaphore 
entry. 
FILES 
/UNIX system namelist 


/devikmem memory 
/etc/passwd user names 
/etc/group group names 


SEE ALSO 
msgop(2), semop(2), shmop(2) in the Sys5 UNIX Programmer 
Reference Manual. 


BUGS 
Things can change while /pcs is running; the picture it gives is only 
a close approximatian to reality. 
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NAME | 


SYNOPSIS 


join [ options ] file1 file2 


DESCRIPTION 


Page 1 


Join forms, on the standard output, a join of the two relations speci- 
fied by the lines of file? and file2 . If file? is -, the standard input is 
used. 


File1 and file2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be joined, normally the first in 
each line. 


There is one line in the output for each pair of lines in file? and file2 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from file? , then the rest 
of the line from file2 . 


The default input field separators are blank, tab, or new-line. In this 
case, multiple separators count as one field separator, and leading 
separators are ignored. The default output field separator is a 
blank. 


Some of the below options use the argument n . This argument 
should be a 1 or a 2 referring to either file? or file2 , respectively. 
The following options are recognized: 


-an In addition to the normal output, produce a line for each 
unpairable line in filen, where n is 1 or 2. 


-es Replace empty output fields by strings . 


-jn m Join on the m th field of file n . If n is missing, use the m th 
field in each file. Fields are numbered starting with 1 . 


~O list Each output line comprises the fields specified in fist , each 
element of which has the form n.m, where n is a file number 
and m is a field number. The common field is not printed 
unless specifically requested. 


—tc Use character c as a separator (tab character). Every 
appearance of c in a line is significant. The character c is 
used as the field separator for both input and output. 
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EXAMPLE 
( : The following command line will join the password file and the group 
file, matching on the numeric group ID, and outputting the login 
name, the group name and the login directory. It is assumed that 
the files have been sorted in ASCII collating sequence on the group 
ID fields. : 


join -j1 4 -j2 3-0 1.1 2.1 1.6 -t: ‘etc/passwd /etc/group 
SEE ALSO 
awk(1), comm(1), sort(1), uniq(1). 


BUGS 
With default field separation, the collating sequence is that of sort 
-b ; with -t , the sequence is that of a plain sort. 


The conventions of join, sort, comm, uniq and awk (17) are wildly 
incongruous. . 


Filenames that are numeric may cause conflict when the -o option is 
used right before listing filenames. 
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NAME —_ 
kill — terminate a process Me ot 
SYNOPSIS 
kill [ — signo | PID ... 
DESCRIPTION 


Kill sends signal 15 (terminate) to the specified processes. This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is 
reported by the Shell (unless more than one process is started in a 
pipeline, in which case the number of the last process in the pipeline 
is reported). Process numbers can also be found by using ps (7). 


The details of the kill are described in kill (2). For example, if pro- 
cess number 0 is specified, all processes in the process group are 
signaled. 
The killed process must belong to the current user unless he is the 
Super-user. | 
If a signal number preceded by — is given as first argument, that sig- 
nal is sent instead of terminate (see signal (2)). In particular “kill —9 
... 1S a sure kill. 

SEE ALSO 


ps(1), sh(1). | 
kill(2), signal(2) in the Sys5 UNIX Programmer Reference Manual. 
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ld — link editor for common object files 


SYNOPSIS 


Id [options] filename 


DESCRIPTION 
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The /d command combines several object files into one, performs 
relocation, resolves external symbols, and supports symbol table 
information for symbolic debugging. In the simplest case, the 
names of several object programs are given, and /d combines them, 
producing an object module that can either be executed or used as 
input for a subsequent /d run. The output of /d is left in a.out . By 
default this file is executable if no errors occurred during the load. If 
any input file, file-name , is not an object file, /d assumes it ts either 
an archive library or a text file containing link editor directives. (See 
the Link Editor User Guide in the Sys5 UNIX Programmer Guide for 
a discussion of input directives.) 


If any argument is a library, it is searched exactly once at the point it 
is encountered in the argument list. Only those routines defining an 
unresolved external reference are loaded. The library (archive) 
symbol table (see ar (4)) is searched sequentially with as many 
passes aS are necessary to resolve external references which can 
be satisfied by library members. Thus, the ordering of library 
members is unimportant. 


The following options are recognized by /d . 


~e epsym 
Set the default entry point address for the output file to be 
that of the symbol epsym . 


—f fill Set the default fill pattern for “holes” within an output sec- 
tion as well as initialized bss sections. The argument fill is a 
two-byte constant. 


—Ix Search a library libx.a, where x is up to seven characters. 

| A library is searched when its name is encountered, so the 

placement of a -I is significant. By default, libraries are 
located in /lib and /usr/lib,. 


—m Produce a map or listing of the input/output sections on the 
standard output. 


-o outfile 
Produce an output object file by the name outfile . The 
name of the default object file is a.out . 
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Retain relocation entries in the output object file. Relocation “> 
entries must be saved if the output file is to become an \_’ 


input file in a subsequent /d run. The link editor will not 
complain about unresolved references. 


Strip line number entries and Syme table information from 
the output object file. 


Turn off the warning about mute -defined symbols that are 
not the same size. 


-u symname 


—X 
symbol table; enter external and static symbols only. This 
option saves some space in the output file. 
-L dir Change the algorithm of searching for libx.a to look in dir 
before looking in /lib and ‘usr/lib. This option is effective 
only if it precedes the -I option on the command line. Pa 
—M Output a message for each multiply-defined external defini- . 
tion. However, if the objects being loaded include debug- 
ging information, extraneous output is produced (see the —g 
option in cc(1)). 
—N Put the data section immediately following the text in the 
output file. 
-V Output a message giving information about the version of Id 
being used. 
-VS num | 
Use num as a decimal version stamp identifying the a.out 
file that is produced. The version stamp is stored in the 
optional header. 
FILES 
/lib/libx.a libraries 
/usr/lib/libx.a libraries 
a.out output file 
SEE ALSO 
as(1), cc(1). | ge 
exit(2), a.out(4), a:(4) in the Sys5 UNIX Programmer Reference — 
Manual. aed 
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Enter symname as an undefined symbol in the symbol 
table. This is useful for loading entirely from a library, since 
initially the symbol table is empty and an unresolved refer- 
ence is needed to force the loading of the first routine. 


Do not preserve local (non-.globi) symbols in the output 
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CAVEATS , 
Through its options and input directives, the common link editor 
gives users great flexibility; however, those who use the input direc- 
tives must assume some added responsibilities. Input directives 
and options should insure the following properties for programs: 


—  C defines a zero pointer as null. A pointer to which zero has 
been assigned must not point to any object. To satisfy this, 
users must not place any object at virtual address zero in the 
data space. 


— When the link editor is called through cc (7), a startup routine 
is linked with the user's program. This routine calls exit() (see 
exit (2)) after execution of the main program. If the user calls 
the link editor directly, then the user must insure that the pro- 
gram always calls exit() rather than falling through the end of 
the entry routine. 
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NAME 
| lex — generate programs for simple lexical tasks — 
SYNOPSIS 
lex [ -retvn ] [ file ] ... 
DESCRIPTION _ 


Lex generates programs to be used in simple lexical analysis of 
text. | = > 


The input files (standard input default) contain strings and expres- 
sions to be searched for, and C text to be executed when strings 
are found. i | 


A file lex.yy.c is generated which, when loaded with the library, 
copies the input to the output except when.a string specified in the 
file is found; then the corresponding program text is executed. The 
actual string matched is left in yytext , an external character array. 
Matching is done in order of the strings in the file. The strings may 
contain square brackets to indicate character classes, as in [abx—-z] 
to indicatea, b, x,y, and z; and the operators +, + ,and ? 
mean respectively any non-negative number of, any positive number 
of, and either zero or one occurrences of, the previous character or 


character class. The character . is the class of all ASCIl characters , 
except new-line. Parentheses for grouping and vertical bar for alter- ‘. 


nation are also supported. The notation r{d,e} in a rule indicates 
between d and e instances of regular expression r . It has higher 
precedence than |, but lower than * , ?, + , and concatenation. 
The character * at the beginning of an expression permits a suc- 
cessful match only immediately after a new-line, and the character $ 
at the end of an expression requires a trailing new-line. The charac- 
ter / in an expression indicates trailing context; only the part of the 
expression up to the slash is returned in yytext , but the remainder 
of the expression must follow in the input stream. An operator char- 
acter may be used as an ordinary symbol if it is within “ symbols or 
preceded by \. Thus [a—-zA-Z]+ matches a string of letters. 


Three subroutines defined as macros are expected: input() to read 
a character; unput(c) to replace a character read; and output(c) to 
place an output character. They are defined in terms of the stan- 
dard streams, but you can override them. The program generated 
is named yylex() , and the library contains a main() which calls. it. 
The action REJECT on the right side of the rule causes this match to 
be rejected and the next suitable match executed; the function 
yymore() accumulates additional characters into the same yyfext ; 
and the function yyless(o) pushes back the portion of the string 
matched beginning at p , which should be between yytext and 


May 27, 1985 


LEX(1) UNIX Sys5 LEX(1) 


yytext + yyleng . The macros input and output use files yyin and 
yyout to read from and write to, defaulted to stdin and stdout , 
respectively. 


Any line beginning with a blank is assumed to contain only C text 
and is copied; if it precedes %% it is copied into the external defini- 
tion area of the lex.yy.c file. All rules should follow a %% , as in 
YACC. Lines preceding %% which begin with a non-blank character 
define the string on the left to be the remainder of the line; it can be 
called out later by surrounding it with {} . Note that curly brackets do 
not imply parentheses; only string substitution is done. 


EXAMPLE 
D (ome) 


if printf("IF statementin’); 
[a—z]+  printf("tag, value %s\n",yytext); 
O{D}+  printf("octal number %s\n",yytext); 
{D}+ printf("“decimal number %s\n" yytext); 
"++" printf("unary op\n’); 
"4" printf(“binary op\n’); 
"foe" { loop: 
while (input() |= ‘*‘); 
switch (input()) 
{ 
case '’: break; 
case '*': unput(’*’); 
default: go to loop; 
i 
i 


The external names generated by /ex all begin with the prefix yy or 
YY. 


The flags must appear before any files. The flag -r indicates RAT- 
FOR actions, —c indicates C actions and is the default, -t causes the 
lex.yy.c program to be written instead to standard output, -v pro- 
vides a one-line summary of statistics of the machine generated, —n 
will not print out the -— summary. Multiple files are treated as a sin- 
gle file. If no files are specified, standard input is used. 


Certain table sizes for the resulting finite state machine can be set 
in the definitions section: 


%pn number of positions is n (default 2000) 


%nn number of states is n (500) 
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%tn number of parse tree nodes is n (1000) 
%an number of transitions is n (3000) 


The use of one or more of the above automatically implies the -v 
option, unless the -n option is used. | | 


SEE ALSO) 
yacc(1). 7 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


BUGS | 
The -r option is not yet fully operational. 
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- NAME 


line — read one line 


SYNOPSIS 
line 

DESCRIPTION : 
Line copies one line (up to a new-line) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on EOF 
and always prints at least a new-line. It is often used within shell 
files to read from the user's terminal. 


SEE ALSO 
sh(1). 
read(2) in the Sys5 UNIX Programmer Reference Manual. 


Page 1 May 23, 1985 


LINT(1) UNIX Sys5 LINT(1) 


NAME 


lint - a C program checker 


SYNOPSIS 


lint [ option ] ... file ... 


DESCRIPTION 
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Lint attempts to detect features of the C program files that are likely 
to be bugs, non-portable, or wasteful. It also checks type usage 
more strictly than the compilers. Among the things that are 
currently detected are unreachable statements, loops not entered at 
the top, automatic variables declared and not used, and logical 
expressions whose value is constant. Moreover, the usage of func- 
tions is checked to find functions that return values in some places 
and not in others, functions called with varying numbers or types of 
arguments, and functions whose values are not used or whose 
values are used but none returned. 


Arguments whose names end with .c are taken to be C source files. 
Arguments whose names end with .In are taken to be the result of 
an earlier invocation of /int with either the -c or the -o option 
used. The .In files are analogous to .o (object) files that are pro- 
duced by the cc (7) command when given a.c file as input. Files 
with other suffixes are warned about and ignored. 


Lint will take all the .c , .In , and Ilib-Ix.In (specified by -Ix) files * 
and process them in their command line order. By default, /int 
appends the standard C lint library (Ilib-Ic.In) to the end of the list of 
files. However, if the —p option is used, the portable C lint library 


(Ilib-port.In) is appended instead. When the —c option is not used, 


the second pass of lint checks this list of files for mutual compatibil-_ 
ity. When the -c option is used, the .In and the Ilib-lx.In files are 


ignored. 


Any number of lint options may be used, in any order, intermixed 
with file-name arguments. The following options are used to 
suppress certain kinds of complaints: 


-a Suppress complaints about assignments of long values to 
variables that are not long. 


—-b Suppress complaints about break statements that cannot 
be reached. (Programs produced by /ex or yacc will often 
result in many such complaints). 


—h Do not apply heuristic tests that attempt to intuit bugs, 
improve style, and reduce waste. 


—U Suppress complaints about functions and external variables | 
used and not defined, or defined and not used. (This option 
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is Suitable for running /int on a subset of files of a larger 
program). 


Suppress complaints about unused arguments in functions. 


Do not report variables referred to by external declarations 
but never used. 7 


The following arguments alter /int 's behavior: 


—Ilx 


-n 


-p 


—-o lib 


Include additional lint library Ilib-lx.In. For example, you 
can include a lint version of the Math Library Ilib-lm.In by 
inserting -Im on the command line. This argument does 
not suppress the default use of Ilib-lc.ln . These lint 
libraries must be in the assumed directory. This option can 
be used to reference local lint libraries and is useful in the 
development of multi-file projects. 


Do not check compatibility against either the standard or the 
portable lint library. 


Attempt to check portability to other dialects (IBM and 
GCOS) of C. Along with stricter checking, this option causes 
all non-external names to be truncated to eight characters 
and all external names to be truncated to six characters and 
one case. 


Cause lint to produce a .In file for every .c file on the com- 
mand line. These .In files are the product of /int 's first pass 
only, and are not checked for inter-function compatibility. 


Cause lint to create a lint library with the name Ilib-I/ib.In. 
The -—c option nullifies any use of the —o option. The lint 
library produced is the input that is given to lint 's second 
pass. The —o option simply causes this file to be saved in 
the named lint library. To produce a Ilib-I/ib.In without 
extraneous messages, use of the —x option is suggested. 
The —v option is useful if the source file(s) for the lint library 
are just external interfaces (for example, the way the file 
llib-ic is written). These option settings are also available 
through the use of “lint comments” (see below). 


The -D , -U , and -I options of cpp (1) and the -—g and —O options 
of cc (1) are also recognized as separate arguments. The -g and 
-O options are ignored, but, by recognizing these options, lint ‘s 
behavior is closer to that of the cc (1) command. Other options are 
warned about and ignored. The pre-processor symbol ‘lint’ is 
defined to allow certain questionable code to be altered or removed 
for fint . Therefore, the symbol “lint” should be thought of as a 
reserved word for all code that is planned to be checked by J/int . 


May 23, 1985 


Page 2 


LINT(1) UNIX Sys5 LINT(1) 


FILES 
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Certain conventional comments in the C source will change the jer 


behavior of lint : 


H* NOTREACHED:: 
at appropriate points stops comments. about 
unreachable code. (This comment is_ typically 
placed just after calls to functions like exit (2)). 


*VARARGSnN #:; 
suppresses the usual checking for variable numbers 
of arguments in the following function declaration. 
The data types of the first m arguments are 
checked; a missing rn is taken to be 0. 


/* ARGSUSED*: 
turns on the -v option for the next function. 


/*LINTLIBRARY *; 
at the beginning of a file shuts off complaints about 
unused functions and function arguments in this file. 
This is equivalent to using the -v and —x options. 


Lint produces its first output on a per-source-file basis. Complaints 
regarding included files are collected and printed after all source 
files have been processed. Finally, if the -c option is not used, 
information gathered from all input files is collected and checked for 
consistency. At this point, if it is not clear whether a complaint 
stems from a given source file or from one of its included files, the 
source file name will be printed followed by a question mark. 


The behavior of the -—c and the -o options allows for incremental 
use of lint on a set of C source files. Generally, one invokes /int 
once for each source file with the —c option. Each of these invoca- 
tions produces a .In file which corresponds to the .c file, and prints 
all messages that are about just that source file. After all the source 
files have been separately run through /int , it is invoked once more 
(without the —c option), listing all the .In files with the needed -Ix 
options. This will print all the inter-file inconsistencies. This scheme 
works well with make (7); it allows make to be used to /int only the 
source files that have been modified since the last time the set of 
source files were flint ed. 


/usr/lib the directory where the lint libraries specified by 
the -Ix option must exist 

/usr/lib/lint[1 2] first and second passes 

/usr/lib/Ilib-Ic.In declarations for C Library functions (binary format; 
source is in /usr/lib/Ilib-Ic ) 
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source is in /usr/lib/Ilib-port ) 

/usrilib/llib-lm.In declarations for Math Library functions (binary for- 
mat; source is in /usr/lib/Ilib-Ilm ) 

/usritmp, *lint* temporaries 


SEE ALSO 
cc(1), cpp(1), make(1). 


( , /usrilib/llib-port.In declarations for portable functions (binary format; 


BUGS 
exit (2), longijmp (3C), and other functions that do not return are not 


understood; this causes various lies. 
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NAME 


login — sign on 


SYNOPSIS 


login [ name [ env-var ... ]] 


DESCRIPTION 
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The login command is used at the beginning of each terminal ses- 
sion and allows you to identify yourself to the system. It may be 
invoked as a command or by the system when a connection is first 
established. Also, it is invoked by the system when a previous user 
has terminated the initial shell by typing a cnitri-d to indicate an 
“end-of-file.” (See How to Get Started at the beginning of this 
volume for instructions on how to dial up initially. ) 


If jlogin is invoked as a command it must replace the initial com- 
mand interpreter. This is accomplished by typing: 

exec login 
from the initial shell. 


Login asks for your user name (if not supplied as an argument), 
and, if appropriate, your password. Echoing is turned off (where 
possible) during the typing of your password, so it will not appear on 
the written record of the session. 


At some installations, an option may be invoked that will require you __ 
to enter a second “dialup” password. This will occur only for dial-up 


connections, and will be prompted by the message “dialup pass- 
word:”. Both passwords are required for a successful login. 


lf you do not complete the login successfully within a certain period 
of time (e€.g., one minute), you are likely to be silently disconnected. 


After a successful login, accounting files are updated, the procedure 
/etc/profile is performed, the message-of-the-day, if any, is printed, 
the user-ID, the group-ID, the working directory, and the command 
interpreter (usually sh (7)) is initialized, and the file .profile in the 
working directory is executed, if it exists. These specifications are 
found in the /etc/passwd file entry for the user. The name of the 
command interpreter is — followed by the last component of the 
interpreter's pathname (i.e., -sh ). If this field in the password file is 
empty, then the default command interpreter, /bin/sh is used. If this 
field is ‘“*”, then a chroot (2) is done to the directory named in the 
directory field of the entry. At that point /ogin is re-executed at the 
new level which must have its own root structure, including 
/etc/login and /etc/passwd . 
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( The basic environment (see environ (5)) is initialized to: 


HOME = your-login-directory 

PATH = :/bin:/usr/bin 

SHELL = /ast-field-of-passwd-entry 
MAIL = /usr/mail/your-login-name 
TZ= timezone-specification 


The environment may be expanded or modified by supplying addi- 
tional arguments to /ogin, either at execution time or when /ogin 
requests your login name. The arguments may take either the form 
XXX Or xxx =yyy. Arguments without an equal sign are placed in the 
environment as 


Lin — xxx 
where n is a number starting at O and is incremented each time a 
new variable name is required. Variables containing an = are 


placed into the environment without modification. If they already 
appear in the environment, then they replace the older value. There 
are two exceptions. The variables PATH and SHELL cannot be 
changed. This prevents people, logging into restricted shell environ- 
ments, from spawning secondary shells which are not restricted. 
a Both login and getty understand simple single-character quoting 
( canventions. Typing a backslash in front of a character quotes it 
= and allows the inclusion of such things as spaces and tabs. 


FILES 
/etc/utmp accounting 
‘ete: wtmp accounting 
‘ust/mail/your-name mailbox for user your-name 
‘etc/motd message-of-the-day 
‘etc/passwd password file 
/ete/profile system profile 
profile user's login profile 

SEE ALSQ 


mail(1), newgrp(1), sh(1), su(1). 
passwd(4), profile(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 


DIAGNOSTICS 
Login incorrect if the user name or the password cannot be 
matched. 
No shell, cannot open password file, or no directory: consult a UNIX 
system programming counselor. 
No utmp entry. You must exec "login" from the lowest level "sh". if 
you attempted to execute /fogin as a command without using the 
shell’s exec internal command or from other than the initial shell. 
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NAME | 
logname — get login name 


SYNOPSIS 
logname 


DESCRIPTION 
Logname returns the contents of the environment variable $LOG- 
NAME, which is set when a user logs into the system. 


FILES 
/etc/profile 
SEE ALSO 
env(1), login(1). 
logname(3X), environ(5) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 


lorder — find ordering relation for an object library 


SYNOPSIS 
lorder file ... 


DESCRIPTION . 

The input is one or more object or library archive files (see ar (1)). 
The standard output is a list of pairs of object file names, meaning 
that the first file of the pair refers to external identifiers defined in the 
second. The output may be processed by tsort (7) to find an order- 
ing of a library suitable for one-pass access by /d (17). Note that the 
link editor Id (17) is capable of multiple passes over an archive in the 
portable archive format (see ar (4)) and does not require that lorder — 
(1) be used when building an archive. The usage of the /order (17) 
command may, however, allow for a slightly more efficient access of 
the archive during the link edit process. 


The following example builds a new library from existing .o files. 
ar cr library * lorder *.o | tsort: 


FILES 
_ *symref, «symdef temporary files 
( ‘SEE ALSO 
a ar(1), Id(1), tsort(1). 
ar(4) in the Sys5 UNIX Programmer Reference Manual. 
BUGS 
Object files whose names do not end with .o , even when contained 
in library archives, are overlooked. Their global symbols and refer- 
ences are attributed to some other file. 
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NAME 

lp, cancel — send/cancel requests to an LP line printer 
SYNOPSIS 


Ip [-c] [-ddest] [-m] [—nnumber] [—ooption] [-s] [-ttitle] [—w] 
files 
cancel [ids] [printers ] 


DESCRIPTION 
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Lp arranges for the named files and associated information (collec- 
tively called a request ) to be printed by a line printer. If no file 
names are mentioned, the standard input is assumed. The file 
name — stands for the standard input and may be supplied on the 
command line in conjunction with named files . The order in which 
files appear is the same order in which they will be printed. 


Lp associates a unique /d with each request and prints it on the 
standard output. This id can be used later to cancel (see cancel ) 
or find the status (see /pstat (1)) of the request. 


The following options to /p may appear in any order and may be 
intermixed with file names: 


—C Make copies of the files to be printed immediately when 


Ip is invoked. Normally, files will not be copied, but will . 
be linked whenever possible. If the ~c option is not ~ 


given, then the user should be careful not to remove any 
of the files before the request has been printed in its 
entirety. It should also be noted that in the absence of 
the -c option, any changes made to the named files 
after the request is made but before it is printed will be 
reflected in the printed output. 


—ddest Choose dest as the printer or class of printers that is to 
do the printing. If dest is a printer, then the request will 
be printed only on that specific printer. If dest is a class 
of printers, then the request will be printed on the first 
available printer that is a member of the class. Under 
certain conditions (printer unavailability, file space limita- 
tion, etc.), requests for specific destinations may not be 
accepted (see accept (1M) and /pstat (7)). By default, 
dest is taken from the environment variable LPDEST (if it 


is set). Otherwise, a default destination (if one exists) 


for the computer system is used. Destination names 
vary between systems (see /pstat (7) ). 


—m send mail (see mail(1)) after the files have been 
printed. By default, no mail is sent upon normal comple- 
tion of the print request. 
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—nnumber Print number copies (default of 1) of the output. 


—ooption 


—S 


—ttitle 


—W 


Specify printer-dependent or class-dependent options . 
Several such options may be collected by specifying the 
-o keyletter more than once. For more information 
about what is valid for options , see Models in Ipadmin 
(1M). 


Suppress messages from /p (1) such as “request id is 


Print title on the banner page of the output. 


Write a message on the user's terminal after the files 
have been printed. If the user is not logged in, then mail 
will be sent instead. 


Cancel cancels line printer requests that were made by the /p (7) 
command. The command line arguments may be either request ids 
(as returned by /p (7)) or printer names (for a complete list, use 
lpstat (1)). Specifying a request id cancels the associated request 
even if it is currently printing. Specifying a printer cancels the 
request which is currently printing on that printer. In either case, the 
cancellation of a request that is currently printing frees the printer to 
_ print its next available request. 


( ‘FILES 


/ust/spool/|p/* 


SEE ALSO 


enable(1), lpstat(1), mail(1). 
accept(1M), lpadmin(1M), lIpsched(1M) in the "Sys5 UNIX Adminis- 
trator Reference Manual" . 
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NAME | 

Iphold, Iprun — postpone printing, resume printing / 

SYNOPSIS aoe 
/usr/bin/lphold [ id ] 


/usr/bin/Iprun [ id ] 


DESCRIPTION 
Lphold postpones the printing of the request whose request identifi- 
cation is id until an /prun command is received for that request. 
Lprun causes resumption of printing of the request whose identifi- 


cation number is jd, which was previously put on hold by the /phold | 


command. The request is placed last in the queue. 


SEE ALSO 
accept(1m), Ilpadmin(1m), lpsched(1m), 
enable(1), lp(1), Ipstat, in the Sys5 UNIX User’s Reference Manual. 
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NAME 


lpstat — print LP status information 


~ SYNOPSIS 


Ipstat [options ] 


DESCRIPTION 
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Lpstat prints information about the current status of the LP line 
printer system. 


If no options are given, then /pstat prints the status of all requests 
made to /p (1) by the user. Any arguments that are not options are 
assumed to be request ids (as returned by /p ). Lostat prints the 
status of such requests. Options may appear in any order and may 
be repeated and intermixed with other arguments. Some of the 
Keyletters below may be followed by an optional /ist that can be in 
one of two forms: a list of items separated from one another by a 
comma, or a list of items enclosed in double quotes and separated 
from one another by a comma and/or one or more spaces. For 
example: 


—u"userl, user2, user3"” 


The omission of a list following such keyletters causes all informa- 
tion relevant to the keyletter to be printed, for example: 


lpstat -o 
prints the status of all output requests.. 


-—a [list] Print acceptance status (with respect to /p ) of destina- 
tions for requests. List is a list of intermixed printer 
names and class names. 


—cC [list] Print class names and their members. List is a list of 
class names. 


—d Print the system default destination for /p . 


—O [list] Print the status of output requests. List is a list of inter- 
mixed printer names, class names, and request /ds . 


—p [/ist] Print the status of printers. List is a list of printer names. 
—f - Print the status of the LP request scheduler 


—S Print a status summary, including the status of the line 
printer scheduler, the system default destination, a list of 
class names and their members, and a list of printers and 
their associated devices. 


—{ Print all status information. 


—u [list] Print status of output requests for users. List is a list of 
login names. 
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~v [list] Print the names of printers and the pathnames of the dev- _ 
ices associated with them. List is a list of printer names. “> 


FILES -, 
/ust/spool/lp/* 


SEE ALSO 
enable(1), Ip(1). 
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Put a slash (/) after each filename if that file is a directory. 


Put a slash (/) after each filename if that file is a directory, 
and put an asterisk (*) after each filename if that file is exe- 
cutable. 


Force printing of non-graphic characters to be in the octal 
/ddd notation. 


Force printing of non-graphic characters in the file names as 
the character (7). 


For each file, print the i-number in the first column of the 
report. 


Give size in 1024-byte blocks (including indirect blocks) for 
each entry. 


Force each argument to be interpreted as a directory and 
list the name found in each slot. This option turns off —I, -t, 
—S, and —-r, and turns on —a; the order is the order in which 
entries appear in the directory. 


The mode printed under the -I option consists of 10 characters that 
are interpreted as follows: | 
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The first character is: 


dif the entry is a directory; 

b if the entry Is a block special file; 

cif the entry is a character special file; 

pif the entry is a fifo (a.k.a. “named pipe’) spe- 

Cial file; 

- if the entry is an ordinary file. 
The next 9 characters are interpreted as three sets of three 
bits each. The first set refers to the owner's permissions; 
the next to permissions of others in the user-group of the 
file; and the last to all others. Within each set, the three 
characters indicate permission to read, to write, and to exe- 
cute the file as a program, respectively. For a directory, 
“execute” permission is interpreted to mean permission to 
search the directory for a specified file. 


The permissions are indicated as follows: 


if the file is readable; 

if the file is writable; 

if the file is executable; 

if the indicated permission is not granted. 


lIxs-7 


The group-execute permission character is given as s if the 
file has set-group-ID mode; likewise, the user-execute per- 
mission character is given as s if the file has set-user-ID 
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NAME . 7 
ls — list contents of directories | | —_ 
; - 
SYNOPSIS : ees 
Is [ -RadCxmnlogrtucpFbqaisf ] names 
DESCRIPTION 


For each directory named, /s lists the contents of that directory; for 
each file named, /s repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several 
arguments are given, the arguments are first sorted appropriately, 
but file arguments are processed before directories and their con- 
tents. There are several options: 


-R Recursively list subdirectories SReouiteted. 

~a List all entries; in the absence of this option, entries whose 
names begin with a period (.) are not listed. 

—d lf argument is a directory, list only its name; often used with 
—| to get the status of a directory. | 

-C Multi-column output with entries sorted down the columns. 

—X Multi-column output with entries sorted across, rather than 


down, the columns. 


—m Stream output format. That is, entries separated by comma a 


and space rather than by newline. 


—I List in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each 
file (see below). If a special file, the size field will contain 
the major and minor device numbers, rather than a size. 


—n The same as -l, except that owner's UID and group’s GID 
numbers are printed, rather than the associated character 
strings. 


~o  Thesameas-t, except that the group is not printed. 
-—g _—s«s The same as —I,, except that the owner is not printed. 
~f 


Reverse the order of sort to get reverse alphabetic or oldest 
first, as appropriate. 


—t Sort by time of last modification (latest first) Instead of by 
name. 


—u Use time of last access elae of last modification for sort- 
ing (with the —-t option) and/or printing (with the —I option). —_ 


—C Use time of last modification of the inode (mode, etc. Yo 
instead of last modification of the file for sorting (-t) and/or 
printing (—l). 
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mode. The last character of the mode (normally x or — ) is t 
if the 1000 (octal) bit of the mode is on; see chmod (1) for 
the meaning of this mode. The indications of set-ID and 
1000 bit of the mode are capitalized if the corresponding 
execute permission is not set. ee 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is printed. 


FILES 
/etc/passwd to get user IDs for Is —I and Is -o . 
/etc/group to get group IDs for Is -l and Is -g. 
NOTES 
Plexus provides a standalone version of /s in addition to the one that 
runs under Sys5. 
SEE ALSO 
chmod(1), find(1). 
BUGS 
The “-g” and “-o" options are incompatible. — 
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m4 — macro processor 


~ SYNOPSIS 


m4 [ options |] [ files ] 


DESCRIPTION 
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M4 is a macro processor intended as a front end for Ratfor, C, and 
other languages. Each of the argument files is processed in order; 
if there are no files, or if a file name is —, the standard input Is read. 
The processed text is written on the standard output. 


The options and their effects are as follows: 


—e Operate interactively. Interrupts are ignored and the output 
is unbuffered. 


-S Enable line sync output for the C preprocessor (#line ... ) 


-Bint Change the size of the push-back and argument collection 
buffers from the default of 4,096. 


-Hint Change the size of the symbol table hash array from the 
default of 199. The size should be prime. 


-Sint Change the size of the call stack from the default of 100 
slots. Macros take three slots, and non-macro arguments 
take one. 


-Tint Change the size of the token buffer from the default of 512 
bytes. : 
To be effective, these flags must appear before any file names and 
before any —D or -U flags: 
-Dname[=val] 
Defines name to val or to null in val ‘s absence. 


—Uname 
undefines name . 


Macro cails have the form: 
name(argi,arg2, ..., argn) 


The ( must immediately follow the name of the macro. If the name 
of a defined macro is not followed by a (, it is deemed to be a call 
of that macro with no arguments. Potential macro names consist of 
alphabetic letters, digits, and underscore _ , where the first charac- 
ter is not a digit. | 
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Leading unquoted blanks, tabs, and new-lines are ignored while col- 
lecting arguments. Left and right single quotes are used to quote! 
strings. The value of a quoted string is the string stripped of the ed 
quotes. | | 


as 


When a macro name is recognized, its arguments are suliecied by 
searching for a matching right parenthesis. If fewer arguments are 
supplied than are in the macro definition, the trailing arguments are 
taken to be null. Macro evaluation proceeds normally during the 
collection of the arguments, and any commas or right parentheses 
which happen to turn up within the value of a nested call are as 
effective as those in the original input text. After argument collec- 
tion, the value of the macro is pushed back onto the input stream | 
and rescanned. i 


M4 makes available the following built-in macros. They may be 
redefined, but once this is done the original meaning is lost. Their 
values are null unless otherwise stated. 


define _ the second argument is installed as the value of the 
macro whose name is the first argument. Each 
occurrence of $n in the replacement text, where rn is a 
digit, is replaced by the n -th argument. Argument 0 is 
the name of the macro; missing arguments are ~ 
replaced by the null string; $# is replaced by the. 
number of arguments; $* is replaced by a list of all the 
arguments separated by commas; $@ is like $* , but 
each argument is quoted (with the current quotes). 


undefine removes the definition of the macro named in its argu- 
| ment. 
defn returns the quoted definition of its argument(s). It is” 
useful for renaming macros, especially built-ins. 
pushdef like define , but saves any previous definition. 
popdef removes current definition of its argument(s), exposing 


the previous one, if any. 


ifdef if the first argument is defined, the value is the second 
argument, otherwise the third. If there is no third argu- 
ment, the value is null. The word unix is predefined 
on UNIX system versions of m4. 


shift returns all but its first argument. The other arguments 
are quoted and pushed back with commas in between. 
The quoting nullifies the effect of the extra scan that a 
will subsequently be performed. \ Zi 


May 28, 1985 Page 2 


M4(1) UNIX Sys5 M4(1) 


changequote 
change quote symbols to the first and second argu- 
ments. The symbols may be up to five characters 
long. Changequote without arguments restores the 
Original values (i.e., > *). 


changecom change left and right comment markers from the 
default # and new-line. With no arguments, the com- 
ment mechanism is effectively disabled. With one 
argument, the left marker becomes the argument and 
the right marker becomes new-line. With two argu- 
ments, both markers are affected. Comment markers 
may be up to five characters long. 


divert m4 maintains 10 output streams, numbered 0-9. The 
final output is the concatenation of the streams in 
numerical order; initially stream QO is the current 
stream. The divert macro changes the current output 
stream to its (digit-string) argument. Output diverted 
to a stream other than 0 through 9 is discarded. 


undivert causes immediate output of text from diversions 
| named as arguments, or all diversions if no argument. 
Text may be undiverted into another diversion. 

Undiverting discards the diverted text. 


divnum returns the value of the current output stream. 


dni reads and discards characters up to and including the 
next new-line. 


ifelse has three or more arguments. If the first argument is 
the same string as the second, then the value is the 
third argument. If not, and if there are more than four 
arguments, the process is repeated with arguments 4, 
5, 6 and 7. Otherwise, the value is either the fourth 
string, or, if it is not present, null. 


incr returns the value of its argument incremented by 1. 
The value of the argument is calculated by interpreting 
an initial digit-string as a decimal number. 


decr returns the value of its argument decremented by 1. 
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eval 


len 


_ index 


substr 


translit 
include 
sinclude 
syscmd 


sysval 


maketemp 
m4exit 
m4wrap 


errprint 


dumpdef 


traceon 
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evaluates its argument as an arithmetic expression, _ 


Male 


using 32-bit arithmetic. Operators include + ,-—, * ,/ 


ee ae i ; ey 
, % , ~ (exponentiation), bitwise & , |, ~ , and ~ ; rela- ~~ 


tionals; parentheses. Octal and hex numbers may be 
specified as in C. The second argument specifies the 
radix for the result; the default is 10. The third argu- 
ment may be used to specify the minimum number of 
digits in the result. 


returns the number of characters in its argument. 


returns the position in its first argument where the 


second argument begins (zero origin), or —1 if the 


second argument does not occur. 


returns a substring of its first argument. The second 
argument is a zero origin number selecting the first 
character; the third argument indicates the length of 
the substring. A missing third argument is taken to be 


_ large enough to extend to the end of the first string. 


transliterates the characters in its first argument from 
the set given by the second argument to the set given 
by the third. No abbreviations are permitted. 


returns the contents of the file named in the argument. . 


is identical to include , except that it says nothing if the 


file is inaccessible. 


executes the UNIX system command given in the first 


argument. No value is returned. 


is the return code from the last call to syscmd . 


fills in a string of XXXXX in its argument with the 
Current process ID. 


causes immediate exit from m4. Argument 1, if given, 
is the exit code; the default is 0. 


argument 1 will be pushed back at final EOF; example: 


— m4wrap(*cleanup( ) ’) 
prints its argument on the diagnostic output file. 


prints current names and definitions, for the named 
items, or for all if no arguments are given. 


with no arguments, turns on tracing for all macros 
(including built-ins). Otherwise, turns on tracing for 
named macros. 
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traceoff turns off trace globally and for any macros specified. 
pon, Macros specifically traced by traceon can be untraced 
( only by specific calls to traceoff . 


SEE ALSO 
cc(1), cpp(1). 


The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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NAME 
macref — produce cross-reference listing of macro files fe 
SYNOPSIS ae 
macref [-t] [-s] [—n] file ... 
DESCRIPTION | 
The macref program reads the named files (which are assumed to 
be nroff(1)/troff(1) input) and produces a cross-reference listing of 
the symbols in the input. 
A -t in the command line causes a macro table of contents to be 
printed. A —S causes symbol use statistics to be output. 
The default output is a list of the symbols found in the input, each | 
accompanied by a list of all references to that symbol. (This output 
may be defeated by using a —n in the command line). The symbols 
are listed alphabetically in the leftmost column, with the references 
following to the right. Each reference is given in the form: 
[ (NMname)] Mname—] type Inum [#] 
where the fields have the following meanings: 
Mname_ the name of the macro within which the reference occurs. _ 
This field is missing if the reference occurs at the text’ ~ 
level. Any names listed in the NMname part are macros. _/ 
within which Mname is defined. 
type the type associated, by context, with this occurrence of 
the symbol. The types may be: 
r request 
m macro 
d diversion 
cS) string 
n number register 
p parameter (e.g. \$x is a parameter reference to x. 
Note that parameters are never modified, and that 
the only valid parameter symbol names are 1, 2, ... 
9). 
Inum the line number on which the reference occurred. 
# this reference modifies the value of the symbol. 
Generated names are listed under the artificial symbol name 
“sym”. a oF, = 
ee. 
SEE ALSO 


nroff(1), troff(1). 
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mail, rmail — send mail to users or read mail 


."SYNOPSIS 


mail [ -epar | [ -f file ] 


mail [ -t ] persons 


rmail [ -t ] persons 


Mail without arguments prints a user’s mail, message-by-message, 
in last-in, first-out order. For each message, the user is prompted 
with a ?, and a line is read from the standard input to determine the 
disposition of the message: 


<new-line> Go on to next message. 

+ Same as <new-line>. 

d Delete message and go on to next mes- 
sage. 

p Print message again. 

- Go back to previous message. 

s [ files | Save message in the named files (mbox 
is default). 

w [ files | Save message, without tts header, in the 


named files (mbox is default). 
m [ persons |] Mail the message to the named persons 
(yourself is default). 


q Put undeleted mail back in the mailfile 
and stop. 

EOT (control-d) Same as q. 

xX Put all mail back in the mailfile unchanged 
and stop. 

command Escape to the shell to do command. 

* Print a command summary. 


The optional arguments alter the printing of the mail: 


—e 


—P 


—q 


— 
—ffile 


causes mail not to be printed. An exit value of 0 is returned 
if the user has mail; otherwise, an exit value of 1 is 
returned. 

causes all mail to be printed without prompting for disposi- 
tion. 

causes mail to terminate after interrupts. Normally an inter- 
rupt only causes the termination of the message being 
printed. 

causes messages to be printed in first-in, first-out order. 
causes mail to use file (e.g., mbox) instead of the default 
mailfile. 
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When persons are named, mai! takes the standard input up to an 
end-of-file (or up to a line consisting of just a .) and adds it to each 
person's mailfile. The message is preceded by the sender’s name 
and a postmark. Lines that look like postmarks in the message, 
(.e., “From...”) are preceded with a >. The -t option causes the 
message to be preceded by all persons the mail is sent to. A per- 
son is usually a user name recognized by /ogin(1). If a person 
being sent mail is not recognized, or if mai! is interrupted during 
input, the file dead.letter will be saved to allow editing and resend- 
ing. Note that this is regarded as a temporary file in that it is 
recreated every time needed, erasing the previous contents of 
dead.letter. 


To denote a recipient on a remote system, prefix person by the sys- 
tem name and exclamation mark (see uucp(1C)). Everything after 
the first exclamation mark in persons is interpreted by the remote 
system. In particular, if persons contains additional exclamation 
marks, it can denote a sequence of machines through which the 
message is to be sent on the way to its ultimate destination. For 
example, specifying alb!cde as a recipient's name causes the mes- 
sage to be sent to user b!cde on system a. System a will interpret 
that destination as a request to send the message to user cde on 
system b. This might be useful, for instance, if the sending system 
can access system a but not system b, and system a has access to 
system b. Mail will not use uucp if the remote system is the local 
system name (i.e., localsystem!user). 


The mailfile may be manipulated in two ways to alter the function of 
mail. The ofher permissions of the file may be read-write, read- 
only, or neither read nor write to allow different levels of privacy. If 
changed to other than the default, the file will be preserved even 
when empty to perpetuate the desired permissions. The file may 
also contain the first line: 


Forward to person 


which will cause all mail sent to the owner of the maiifile to be for- 
warded to person. This is especially useful to forward all of a 
person’s mail to one machine in a multiple machine environment. In 
order for forwarding to work properly the mailfile should have “mail” 
as group ID, and the group permission should be read-write. 


Rmail only permits the sending of mail; vucp(1C) uses rmail as a 
security precaution. 


When a user logs in, the presence of mail, if any, is indicated. Also, 
notification is made if new mail arrives while using mail. 
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FILES 


/etc/passwd 
/usr/Mail/user 
$SHOME/mbox 
SMAIL 
/tmp/ma* 
/usr/mail/*.lock 
dead.letter 


SEE ALSO 
login(1), mailx(1), uucp(1C), write(1). 


BUGS 
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to identify sender and locate persons 
incoming mail for user; i.e., the mailfile 
saved mail 

variable containing path name of mailfile 
temporary file 

lock for mail directory 

unmailable text 


Conditions sometimes result in a failure to remove a lock file. 
After an interrupt, the next message may not be printed; printing 
may be forced by typing a p. 
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mailx — interactive message processing system 


SYNOPSIS 


mailx [options] [name...] 


DESCRIPTION 
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The command mailx provides a comfortable, flexible environment for 
sending and receiving messages electronically. When reading mail, 
mailx provides commands to facilitate saving, deleting, and respond- 
ing to messages. When sending mail, mai/x allows editing, review- 
ing and other modification of the message as it is entered. 


Incoming mail is stored in a standard file for each user, called the 
system mailbox for that user. When mailx is called to read mes- 
sages, the mailbox is the default place to find them. As messages 
are read, they are marked to be moved to a secondary file for 
storage, unless specific action is taken, so that the messages need 
not be seen again. This secondary file is called the mbox and is 
normally located in the user's HOME directory (see "MBOX" 
(ENVIRONMENT VARIABLES) for a description of this file). Messages 
remain in this file until forcibly removed. 


On the command line, options start with a dash (—) and any other 
arguments are taken to be destinations (recipients). If no recipients 
are specified, mailx will attempt to read messages from the mai/box. 
Command line options are: 


—d Turn on debugging output. Neither particu- 
larly interesting nor recommended. 
os Test for presence of mail. Mailx prints noth- 


ing and exits with a successful return code if 
there is mail to read. 

-f [filename] Read messages from filename instead of 
mailbox. \f no filename is specified, the 
mbox is used. 

—F Record the message in a file named after 

| the first recipient. Overrides the “record” 
variable, if set (See ENVIRONMENT VARI- 
ABLES). 

-—h number The number of network "hops" made so far. 
This is provided for network software to 
avoid infinite delivery loops. 

—-H Print header summary only. 

i Ignore interrupts. See also “ignore” 
(ENVIRONMENT VARIABLES). 
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~—n Do not initialize from the system default 


Mailx.rc file. q 
—N Do not print initial header summary. Boal 
—r address Pass address to network delivery software. 

All tide commands are disabled. 
—s subject Set the Subject header field to subject . 
—u user Read user 's mailbox. This is only effective 

if user 's mailbox is not read protected. 
—U Convert uucp style addresses to internet 


Standards. Overrides the “conv” environ- 
ment variable. 


When reading mail, mai/x is in command mode. A header summary 
of the first several messages is displayed, followed by a prompt indi- 
cating mailx can accept regular commands (see COMMANDS below). 
When sending mail, mailx is in inout mode. If no subject is spect- 
fied on the command line, a prompt for the subject is printed. As 
the message is typed, ma//x will read the message and store it ina 
temporary file. Commands may be entered by beginning a line with 
the tilde (") escape character followed by a single command letter 
and optional arguments. See TILDE ESCAPES for a summary of 
these commands. 


At any time, the behavior of mailx is governed by a set of environ- ~~ 
ment variables. These are flags and valued parameters which are 
set and cleared via the se t and uns et commands. See ENVIRON- 
MENT VARIABLES below for a summary of these parameters. 


Recipients listed on the command line may be of three types: login 
names, shell commands, or alias groups. Login names may be any 
network address, including mixed network addressing. If the reci- 
pient name begins with a pipe symbol (|, the rest of the name is 
taken to be a shell command to pipe the message through. This 
provides an automatic interface with any program that reads the 
standard input, such as /p (7) for recording outgoing mail on paper. 
Alias groups are set by the a lias command (see COMMANDS 
below) and are lists of recipients of any type. 


Regular commands are of the form | 


[ command ]| [ msglist ] [ argu- 
ments | 
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( 


If no command is specified in command mode, p rint is assumed. 
In input mode, commands are recognized by the escape character, 
and lines not treated as commands are taken as input for the mes- 
sage. 


Each message is assigned a sequential number, and there is at any 
time the notion of a ‘current’ message, marked by a ‘>’ In the 
header summary. Many commands take an optional list of mes- 
sages (msglist) to operate on, which defaults to the current mes- 
sage. A msglist is a list of message specifications separated by 
spaces, which may include: 


n Message numbern. 

The current message. 

The first undeleted message. 

$ The last message. 

. All messages. 

n-m An inclusive range of message numbers. 

user All messages from user . 

‘string Ail messages with string in the subject line (case 


a 


ignoreq). 
aC All messages of type c , where c is one of: 
d deleted messages 
n new messages 
fe) old messages 
r read messages 
u unread messages 


Note that the context of the command determines 
whether this type of message specification makes 
sense. 


Other arguments are usually arbitrary strings whose usage depends 
on the command involved. File names, where expected, are 
expanded via the normal shell conventions (see sh (7)). Special 
characters are recognized by certain commands and are docu- 
mented with the commands below. 


At start-up time, mailx reads commands from a system-wide file 
(/usr/lib/mailx/mailx.rc) to initialize certain parameters, then from a 
private start-up file (SHOME/.mailrc) for personalized variables. 
Most regular commands are legal inside start-up files, the most 
common use being to set up initial display options and alias lists. 
The following commands are not legal in the start-up file: !, C opy, 
e dit, fo Ilowup, F ollowup, ho Id, m ail, pre serve, r eply, R eply, 
sh ell, and v isual. Any errors in the start-up file cause the remain- 
ing lines in the file to be ignored. 
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COMMANDS a 
The following is a complete list of mailx commands: 


Ishell-command 
Escape to the shell. See "SHELL" (ENVIRONMENT VARI- 
ABLES). 


# comment 
Null command (comment). This may be useful in .maiirc 
files. 


Print the current message number. 


Prints a summary of commands. 


alias alias name ... 

group alias name ... 
Declare an alias for the given names. The names will be 
substituted when a/ias is used as a recipient. Useful in the 
maiilrc file. Jee 

alternates name ... 
Declares a list of alternate names for your login. When 
responding to a message, these names are removed from 
the list of recipients for the response. With no arguments, 
alt ernates prints the current list of alternate names. See 
also “allnet” (ENVIRONMENT VARIABLES). 


cd [d/rectory] 

chdir [directory] 
Change directory. If directory is not specified, $HOME is 
used. 


copy [filename] 

copy [msglist] filename 
Copy messages to the file without marking the messages as 
saved. Otherwise equivalent to the s ave command. 


Copy [msgiist] 
save the specified messages in a file whose name is 
derived from the author of the message to be saved« ~ 
without marking the messages as_ saved. Otherwis\._ Z 
equivalent to the S ave command. - 
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delete [msglist] 
Delete messages from the mailbox. \f "autoprint” is set, the 
next message after the last one deleted is printed (see 
ENVIRONMENT VARIABLES). 


discard [header-field ...] 

ignore [header-field ...| 
Suppresses printing of the specified header fields when 
displaying messages on the screen. Examples of header 
fields to ignore are “status” and "cc." The fields are included 
when the message is saved. The P rint and T ype com- 
mands override this command. 


dp [msglist| 

dt [msglist] 
Delete the specified messages from the mailbox and print 
the next message after the last one deleted. Roughly 
equivalent to a d elete command followed by a p rint com- 
mand. 


echo string ... 
Echo the given strings (like echo (7)). 


edit [msglist] 
Edit the given messages. The messages are placed in a 
temporary file and the "EDITOR" variable is used to get the 
name of the editor (see ENVIRONMENT VARIABLES). 
Default editor is ed (7). 


exit 

xit 
Exit from mailx, without changing the mailbox. No mes- 
sages are saved in the mbox (see also q uit). 


file [filename] 
folder [filename] 
Quit from the current file of messages and read in the speci- 
fied file. Several special characters are recognized when 
used as file names, with the following substitutions: 
% the current mailbox. 
“ouser 
the mailbox for user . 
# the previous file. 
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& the current mbox. a 
Default file is the current mailbox. X 
folders 
Print the names of the files in the directory set by the 
"folder" variable (see ENVIRONMENT VARIABLES). 


followup [message] 
Respond to a message, recording the response in a file 
whose name is derived from the author of the message. 
Overrides the “record” variable, if set. See also the F 
ollowup, S ave, and C opy commands and “outfolder” 
(ENVIRONMENT VARIABLES). | 


Followup [msgiist] 
Respond to the first message in the msglist, sending the 
message to the author of each message in the msgiist. The 
subject line is taken from the first message and the 
response is recorded in a file whose name is derived from 
the author of the first message. See also the fo llowup, $ 
ave, and C opy commands and “outfolder” (ENVIRONMENT 
VARIABLES). —_ 
from [msglist| 
Prints the header summary for the specified messages. 


group alias name ... 

alias alias name ... 
Declare an alias for the given names. The names will be 
substituted when alias is used as a recipient. Useful in the 
.mailrc file. 


headers [message] 
Prints the page of headers which includes the message 
specified. The "screen" variable sets the number of 
headers per page (see ENVIRONMENT VARIABLES). See 
also the z command. 


help 
Prints a summary of commands. 


hold [msglist| | = 


preserve [msgliist¢] 
Holds the specified messages in the mailbox. eee 
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if sh 

mail-commands 

else 

mail-commands 

endif 
Conditional execution, where s will execute following mail- 
commands, up to an el se or en dif, if the program is in 
send mode, and r causes the mail-commands to be exe- 
cuted only in receive mode. Useful in the .maiirc file. 


ignore header-field ... 

discard header-field ... 
Suppresses printing of the specified header fields when 
displaying messages on the screen. Examples of header 
fields to ignore are "status" and "cc." All fields are included 
when the message is saved. The P rint and T ype com- 
mands override this command. 


list 
Prints all commands available. No explanation is given. 


mail name ... 
Mail a message to the specified users. 


mbox [msglist] 
Arrange for the given messages to end up in the standard 
mbox save file when mailx terminates normally. See 
"MBOX" (ENVIRONMENT VARIABLES) for a description of 
this file. See also the ex it and q uit commands. 


next [message] 

Go to next message matching message. A msglist may be 
specified, but in this case the first valid message in the list 
is the only one used. This is useful for jumping to the next 
message from a specific user, since the name would be 

taken as a command in the absence of a real command. 
See the discussion of msglists above for a description of 
possible message specifications. 


pipe [msglist] [shell-commanda] 

| {msglist] [shell-command] 
Pipe the message through the given shell-command. The 
message is treated as if it were read. If no arguments are 
given, the current message is piped through the command 
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specified by the value of the "cmd" variable. If the "page" | y 


variable is set, a form feed character is inserted after each 
message (see ENVIRONMENT VARIABLES). 


preserve [msgiist¢] 
hold [msgiist] 
Preserve the specified messages in the ma/box. 


Print [msglist] 

Type [msglist] — 
Print the specified messages on the screen, including all 
header fields. Overrides suppression of fields by the ig 
nore command. 


print [msgiist] 

type [msglist] 
Print the specified messages. If "crt" is set, the messages 
longer than the number of lines specified by the "crt" vari- 
able are paged through the command specified by the 
"PAGER" variable. The default command is pg (7) (see 
ENVIRONMENT VARIABLES). 


quit 
Exit from mailx, storing messages that were read in mbox 
and unread messages in the mailbox. Messages that have 
been explicitly saved in a file are deleted. 


Reply [msgiist] 

Respond [msglist] 
send a response to the author of each message in the 
msglist. The subject line is taken from the first message. If 
"record" is set to a filename, the response is saved at the 
end of that file (see ENVIRONMENT VARIABLES). 


reply [message] 

respond [message] 
Reply to the specified message, including all other reci- 
pients of the message. If "record" is set to a filename, the 
response is saved at the end of that file (see ENVIRONMENT 
VARIABLES). 


Save [msg/ist| 
Save the specified messages in a file whose name is 
derived from the author of the first message. The name of 
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the file is taken to be the author's name with all network 
addressing stripped off. See also the C opy, fo llowup, 
and F ollowup commands and “outfolder" (ENVIRONMENT 
VARIABLES). 


save [filename] 

save [msglist] filename 
Save the specified messages in the given file. The file is 
created if it does not exist. The message is deleted from 
the mailbox when mailx terminates unless "keepsave’ is set 
(see also ENVIRONMENT VARIABLES and the ex it and q uit 
commands). 


set 

set name 

set name =string 

set name=number 
Define a variable called name. The variable may be given a 
null, string, or numeric value. Se t by itself prints all defined 
variables and their values. See ENVIRONMENT VARIABLES 
for detailed descriptions of the mailx variables. 


shell 
Invoke an interactive shell (see also "SHELL" (ENVIRON- 
MENT VARIABLES)). 


size [msglist] | 
Print the size in characters of the specified messages. 


source filename 
Read commands from the given file and return to command 
mode. 


top [msgiist] | 

| Print the top few lines of the specified messages. If the 
“toplines” variable is set, it is taken as the number of lines to 
print (see ENVIRONMENT VARIABLES). The default is 5. 


touch [msg/iist] 
Touch the specified messages. If any message in msgiist is 
not specifically saved in a file, it will be placed in the mbox 
upon normal termination. See ex it and q uit. 
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-_ 
Type [msgiist] = 7 : ( | 
~ Print [msglist] - ¢ ed 
| Print the specified messages on the screen, including all 
header fields. Overrides suppression of fields by the ig 
nore command. 
type [msgiist] 
print [msglist] 
Print the specified messages. If "crt" is set, the messages 
longer than the number of lines specified by the "crt" vari- 
able are paged through the command specified by the 
"PAGER" variable. The default command is pg (7) (see 
ENVIRONMENT VARIABLES). 
undelete [msglist] | 
Restore the specified deleted messages. Will only restore 
messages deleted in the current mail session. If “autoprint" 
is set, the last message of those restored is printed (see 
ENVIRONMENT VARIABLES). | 
unset name ... an 
Causes the specified variables to be erased. If the variable. 


was imported from the execution environment (i.e., a shell 
variable) then it cannot be erased. 


version 
Prints the current version and release date. 


visual [msgiist] 
Edit the given messages with a screen editor. The mes- 
sages are placed in a temporary file and the "VISUAL" vari- 
able is used to get the name of the editor (see ENVIRON- 
MENT VARIABLES). 


write [msglist] filename 
Write the given messages on the specified file, minus the 
header and trailing blank line. Otherwise equivalent to the s 

ave command. 


xt 
exit | 7 | | : ; 
Exit from mailx, without changing the mailbox. No mes- “ » 
sages are saved in the mbox (see also q uit). Ne 
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z[+t] 
( | Scroll the header display forward or backward one 
ke a? screen-full. The number of headers displayed is set by the 
"screen" variable (see ENVIRONMENT VARIABLES). 


TILDE ESCAPES 
The following commands may be entered only from input mode, by 
beginning a line with the tilde escape character (). See “escape” 
(ENVIRONMENT VARIABLES) for changing this special character. 


“! shell-command 
Escape to the shell. 


Simulate end of file (terminate message input). 
“1 mail-command 
mail-command 


Perform the command-ievel request. Valid only when send- 
ing a message while reading mail. 


Print a summary of tilde escapes. 


Insert the autograph string "Sign" into the message (see 
ENVIRONMENT VARIABLES). 


a 
Insert the autograph string "sign" into the message (see 
ENVIRONMENT VARIABLES). 
“b name ... 
Add the names to the blind carbon copy (Bcc) list. 
“Cc name ... 
Add the names to the carbon copy (Cc) list. 
“d 
Read in the dead./etter file. See "DEAD" (ENVIRONMENT 
VARIABLES) for a description of this file. 
“e 
“ Invoke the editor on the partial message. See also "EDI- 
( TOR" (ENVIRONMENT VARIABLES). 
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“f [msgiist] 


Forward the specified messages. The messages ar ; 
inserted into the message, without alteration. Seaoi? 

“h 
Prompt for Subject line and To, Cc, and Bcc lists. If the 
field is displayed with an initial value, it may be edited as if 
you had just typed tt. | 

“i string 
Insert the value of the named variable into the text of the 
message. For example, “A is equivalent to “i Sign.’ 

“m [msglist] 
Insert the specified messages into the letter, shifting the 
new text to the right one tab stop. Valid only when sending 
a message while reading mail. 

‘Pp 
Print the message being entered. 

q —_ 
Quit from input mode by simulating an interrupt. If the boc, 
of the message is not null, the partial message is saved in ~ 
dead. letter. See "DEAD" (ENVIRONMENT VARIABLES) for a 
description of this file. 

“r filename 

“< filename 


< !shell-command 
Read in the specified file. If the argument begins with an 
exclamation point (!), the rest of the string is taken as an 
arbitrary shell command and is executed, with the standard 
output inserted into the message. 


“S String ... 
Set the subject line to string. 


“tname ... 
Add the given names to the To list. 


Invoke a preferred screen editor on the partial message* > 


See also "VISUAL" (ENVIRONMENT VARIABLES). 4 
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“W filename 
Write the partial message onto the given file, without the 
header. ” 

“xX 


Exit as with “q except the message is not saved in 
dead.letter. 


‘| shell-command 
Pipe the body of the message through the given shell- 
command. lf the shell-command returns a successful exit 
Status, the output of the command replaces the message. 


ENVIRONMENT VARIABLES 
The following are environment variables taken from the execution 
environment and are not alterable within mailx. 


HOME = directory 
The user's base of operations. 


MAILRC = filename 
The name of the start-up file. Default is $HOME- .mailrc. 


The following variables are internal mai/x variables. They may be 
imported from the execution environment or set via the se t com- 
mand at any time. The uns et command may be used to erase 
variables. 


alinet 
All network names whose last component (login name) 
match are treated as identical. This causes the msglist 
message specifications to behave similarly. Default is 
noalinet . See also the alt ernates command and the 
“metoo" variable. 


append 
Upon termination, append messages to the end of the mbox 
file instead of prepending them. Default is noappend. 


askcc 
Prompt for the Cc list after message is entered. Default is 
noaskcc . | 


asksub 


Prompt for subject if it is not specified on the command line 
with the —s option. Enabled by default. 
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autoprint 


Enable automatic printing of messages after d elete and u . 


ndelete commands. Default is noautoprint . 


bang 
Enable the special-casing of exclamation points (!) in shell 
escape command lines as in wi (7). Default is nobang . 


cmd = shell-command 
Set the default command for the pi pe command. No 
default value. 


conv = conversion 
Convert uucp addresses to the specified address style. The 
only valid conversion now is internet , which requires a mail 
delivery program conforming to the RFC822 standard for 
electronic mail addressing. Conversion is disabled by 
default. See also "sendmail" and the -—U command line 
option. | 


crt =number 
Pipe messages having more than number lines through the 
command specified by the value of the "PAGER" variable 
(eg(1) by default). Disabled by default. 


DEAD = filename 
The name of the file in which to save partial letters in case 
of untimely interrupt or delivery errors. Default is 
$HOME/dead.letter. 


debug 
Enable verbose diagnostics for debugging. Messages are 
not delivered. Default is nodebug . 


dot 
Take a period on a line by itself during input from a terminal 
as end-of-file. Default is nodot . 


EDITOR =shell-command 
The command to run when the e dit or “e command is 
used. Default is ed (7). | 


escape=c 
Substitute c for the ~ escape character. 
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directory 

The directory for saving standard mail files. User specified 
file names beginning with a plus (+) are expanded by 
preceding the filename with this directory name to obtain the 
real filename. If directory does not start with a slash (/), 
$HOME is prepended to it. In order to use the plus (+) 
construct on a mailx command line, “folder” must be an 
exported sh environment variable. There is no default for 
the “folder” variable. See also “outfolder” below. 


Enable printing of the header summary when entering mai!x. 
Enabled by default. 


hold 
Preserve all messages that are read in the mailbox instead 
of putting them in the standard mbox save file. Default ts 
nohold . 

ignore 
Ignore interrupts while entering messages. Handy for noisy 
dial-up lines. Default is noignore . 

ignoreeof | 
Ignore end-of-file during message input. Input must be ter- 
minated by a period (.) on a line by itself or by the ~. com- 
mand. Default is noignoreeof . See also “dot” above. 

keep 
When the mailbox is empty, truncate it to zero length 
instead of removing it. Disabled by default. 

keepsave 


Keep messages that have been saved in other files in the 
mailbox instead of deleting them. Default is nokeepsave . 


MBOX = filename 


metoo 
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The name of the file to save messages which have been 
read. The x it command overrides this function, as does 
saving the message explicitly in another file. Default is 
$S$HOME/mbox. 


lf your login appears as a recipient, do not delete it from the 
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list. Default is nometoo. Be. 


LISTER = shell-command | Sau 
The command (and options) to use when listing the con- 
tents of the “folder” directory. The default is /s (7). 


onehop 

When responding to a message that was originally sent to 
several recipients, the other recipient addresses are nor- 
mally forced to be relative to the originating author's 
machine for the response. This flag disables alteration of 
the recipients’ addresses, improving efficiency in a network 
where all machines can send directly to all other machines | 
(i.e., one hop away). 


outfolder | 
Causes the files used to record outgoing messages to be 
located in the directory specified by the “folder” variable 
unless the pathname is absolute. Default is nooutfolder . 
See "folder" above and the S ave, C opy, fo llowup, and F 
ollowup commands. 


page —_ 
Used with the pi pe command to insert a form feed after — 
each message sent through the pipe. Default is nopage . 


PAGER =shell-command 
The command to use as a filter for paginating output. This 
can also be used to specify the options to be used. Default 


is pg (1). 


prompt = string 
Set the command mode prompt to string. Default is "? ". 


quiet 
Refrain from printing the opening message and version 
when entering maix. Default is noquiet . 


record =filename 
Record all outgoing mail in filename. Disabled by default. 
See also “outfolder" above. 

save | _ 
Enable saving of messages in dead./etter on interrupt OK 
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( j 
_ 


FILES 


delivery error. See "DEAD" for a description of this file. 
Enabled by default. 


screen = number 
Sets the number of lines in a screen—full of headers for the 
h eaders command. 


sendmail = shel/l-command 
Alternate command for delivering messages. Default is mai 


(1). 


sendwait 
Wait for background mailer to finish before returning. 
Default is nosendwait . 


SHELL = shell-command 
The name of a preferred command interpreter. Default is sh 


(1). 


showto 
When displaying the header summary and the message is 
from you, print the recipient's name instead of the author's 
name. 


sign=string 
The variable inserted into the text of a message when the “a 
(autograph) command is given. No default (see also ‘i 
(TILDE ESCAPES)). 


Sign =string 
The variable inserted into the text of a message when the 
“A command is given. No default (see also 1 (TILDE 
ESCAPES)). 


toplines =number 
The number of lines of header to print with the to p com- 
mand. Default Is 5. 


VISUAL = shell-command 
The name of a preferred screen editor. Default is wi (7). 


$SHOME/.maiirc personal start-up file 
$HOME/mbox secondary storage file 
/usr/mail/* post office directory 
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-/usr/lib/mailx/mailx.help* - help message files 


/usr/lib/mailx/mailx.re global start-up file 
/tmp/R[emaqsx]* temporary files 
SEE ALSO 


mail(1), pg(1), Is(1). 
BUGS 


Where shell-command is shown as valid, arguments are not always 
allowed. Experimentation is recommended. 


Internal variables imported from the execution environment cannot 
be uns et. 


The full internet addressing is not fully supported by mai/x. The new 


standards need some time to settle down. 


Attempts to send a message having a line consisting only of a °.” 
are treated as the end of the message by mail(1) (the standard mail 
delivery program). 
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-_ NAME 
| make — maintain, update, and regenerate groups of programs 


SYNOPSIS 
make [-f makefile] (—p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [-m] [-t] 
[-d] [-q] [names ] 

DESCRIPTION 


The following is a brief description of all options and some special 
names: 


-—f makefile Description file name. Makefile is assumed to be the 
name of a description file. A file name of — denotes the 
standard input. The contents of makefile override the 
built-in rules if they are present. 


—p Print out the complete set of macro definitions and tar- 
get descriptions. 


-i Ignore error codes returned by invoked commands. 
This mode is entered if the fake target name .IGNORE 
appears in the description file. 


—k Abandon work on the current entry, but continue on 
other branches that do not depend on that entry. 


( ; —S Silent mode. Do not print command lines before exe- 
e cuting. This mode is also entered if the fake target 
name .SILENT appears in the description file. 


—f Do not use the built-in rules. 

—n No execute mode. Print commands, but do not execute 
them. Even lines beginning with an @ are printed. 

—b Compatibility mode for old makefiles. 

—e Environment variables override assignments’ within 
makefiles. 

—m Print a memory map showing text, data, and stack. 


This option is a no-operation on systems without the 
getu system call. 


—t Touch the target files (causing them to be up-to-date) 
rather than issue the usual commands. 
—d Debug mode. Print out detailed information on files and 
times examined. 
a -q Question. The make command returns a zero or non- 
| ( | zero status code depending on whether the target file is 
Lo or is not up-to-date. 
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DEFAULT If a file must be made but there are no explicit cols ~ 
mands or relevant built-in rules, the commands assoc 
ated with the name .DEFAULT are used if it exists. hie 


.PRECIOUS Dependents of this target will not be removed when quit 
or interrupt are hit. 


SILENT Same effect as the —s option. 
IGNORE Same effect as the -i option. 


Make executes commands in makefile to update one or more target 
names . Name is typically a program. If no -f option is present, 
makefile, Makefile, s.makefile, and s.Makefile are tried in order. 
lf makefile is — , the standard input is taken. More than one — — 
makefile argument pair may appear. 7 


Make updates a target only if its dependents are newer than the tar- 
get. All prerequisite files of a target are added recursively to the list 
of targets. Missing files are deemed to be out of date. 


Makefile contains a sequence of entries that specify dependencies. 
The first line of an entry is a blank-separated, non-null list of targets, 
then a: , then a (possibly null) list of prerequisite files or dependen- 
cles. Text following a ; and all following lines that begin with a tab 
are shell commands to be executed to update the target. The fire > 
line that does not begin with a tab or # begins a new dependency.” 
or macro definition. Shell commands may be continued across lines 
with the <backslash><new-line> sequence. Everything printed by 
make (except the initial tab) is passed directly to the shell as is. 


Thus, 
echo a\ 
b 

will produce 
ab 


exactly the same as the shell would. 
Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two files a.o and 
b.o , and that they in turn depend on their corresponding source 
files (a.c and b.c ) and a common file incl.h : 


pgm: a.o b.o 
cc a.0 b.o -O pgm 
a.o: incl. a.c yes 
—_ 
cc -C a.c | 
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b.o: incl.h b.c 
cc -c b.c 


Command lines are executed one at a time, each by its own shell. 
The first one or two characters in a command can be the following: 
-- @, -@, or @-. If @ is present, printing of the command is 
suppressed. If - is present, make ignores an error. A line is printed 
when it is executed unless the -s option is present, or the entry 
-SILENT: is in makefile , or unless the initial character sequence 
contains a @. The —-n option specifies printing without execution; 
however, if the command line has the string $(MAKE) in it, the line is 
always executed (see discussion of the MAKEFLAGS macro under 
Environment ). The -t (touch) option updates the modified date of a 
file without executing any commands. 


Commands returning non-zero status normally terminate make . If 
the -i option is present, or the entry .IGNORE: appears in makefile , 
or the initial character sequence of the command contains -. the 
error is ignored. If the —k option is present, work is abandoned on 
the current entry, but continues on other branches that do not 
depend on that entry. 


The —b option allows old makefiles (those written for the old version 
of make) to run without errors. The difference between the old ver- 
sion of make and this version is that this version requires all depen- 
dency lines to have a (possibly null or-implicit) command associated 
with them. The previous version of make assumed, if no command 
was specified explicitly, that the command was null. 


Interrupt and quit cause the target to be deleted unless the target is 
a dependent of the special name .PRECIOUS. 


Environment 


The environment is read by make. All variables are assumed to be 
macro definitions and processed as such. The environment vari- 
ables are processed before any makefile and after the internal rules; 
thus, macro assignments in a makefile override environment vari- 
ables. The —e option causes the environment to override the macro 
assignments in a makefile. 


The MAKEFLAGS environment variable is processed by make as 
containing any legal input option (except -f, -p, and —d) defined for 
the command line. Further, upon invocation, make “invents” the 
variable if it is not in the environment, puts the current options into 
it, and passes it on to invocations of commands. Thus, 
MAKEFLAGS always contains the current input options. This proves 
very useful for “super-makes”. In fact, as noted above, when the 
—n option is used, the command $(MAKE) is executed anyway: 


May 23, 1985 


MAKE (1) UNIX Sys5 MAKE (1) 


hence, one can perform a make —n recursively on a whole software ~~. 


system to see what would have been executed. This is because the, 


i 
} 


vA 


—n is put in MAKEFLAGS and passed to further invocations of © 


$(MAKE) . This is one way of debugging all of the makefiles for a 
software project without actually doing anything. 


Macros 


Entries of the form string? = string2 are macro definitions. String2 
is defined as all characters up to a comment character or an unes- 
caped new-line. Subsequent appearances of 
$(string1[:subst? =[subst are replaced by string2 . The parentheses 
are optional if a single character macro name is used and there is 


no substitute sequence. The optional :subst?=subst2 is a substi- © 


tute sequence. If it is specified, all non-overlapping occurrences of 
subst? in the named macro are replaced by subst2. Strings (for the 
purposes of this type of substitution) are delimited by blanks, tabs, 
new-line characters, and beginnings of lines. An example of the use 
of the substitute sequence is shown under Libraries . 


Internal Macros 


There are five internally maintained macros which are useful for writ- 
ing rules for building targets. 


$* The macro $* stands for the file name part of the current. 7 


dependent with the suffix deleted. It is evaluated only for 
inference rules. 


$@ The $@ macro stands for the full target name of the current 
target. It is evaluated only for explicitly named dependencies. 


$< The $< macro is only evaluated for inference rules or the 
DEFAULT rule. It is the module which is out-of-date with 
respect to the target (i.e., the “manufactured” dependent file 
name). Thus, in the .c.o rule, the $< macro would evaluate to 
the .c file. An example for making optimized .o files from .c 
files is: 

sC.0. 
cc -c —O $%.c 


or: 
20° 
cc -c -O $< 


$? The $? macro is evaluated when explicit rules from the 
makefile are evaluated. It is the list of prerequisites that are 
out of date with respect to the target; essentially, those 
modules which must be rebuilt. 
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; 


$% The $% macro is only evaluated when the target is an archive 
library member of the form lib(file.o). In this case, $@ evalu- 
ates to lib and $% evaluates to the library member, file.o. 


Four of the five macros can have alternative forms. When an upper 
case D or F is appended to any of the four macros, the meaning is 
changed to ‘directory part” for D and “file part” for F. Thus, $(@D) 
refers to the directory part of the string $@. If there is no directory 
part, ./ is generated. The only macro excluded from this alternative 
form is $?. The reasons for this are debatable. 


Suffixes 
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Certain names (for instance, those ending with .o) have inferable 
prerequisites such as .c, .s, etc. If no update commands for such a 
file appear in makefile , and if an inferable prerequisite exists, that 
prerequisite is compiled to make the target. In this case, make has 
inference rules which allow building files from other files by examin- 
ing the suffixes and determining an appropriate inference rule to 
use. The current default inference rules are: 


0.2) SSNS “C046 20 3.0: -5S0' <S°.0° 70. V0. 120.1750 
y.c y.c ic .oc.a.c.a.s.a inh 


The internal rules for make are contained in the source file rules.c 
for the make program. These rules can be locally modified. To 
print out the rules compiled into the make on any machine in a form 
suitable for recompilation, the following command is used: 


make -fp — 2>/devnull <,/dev/null 


The only peculiarity in this output is the (null) string which printf 
(3S) prints when handed a null string. 


A tilde in the above rules refers to an SCCS file (see sccsfile (4)). 
Thus, the rule .c’.o would transform an SCCS C source file into an 
object file (.o). Because the s. of the SCCS files is a prefix, it Is 
incompatible with make’'s suffix point-of-view. Hence, the tilde is a 
way of changing any file reference into an SCCS file reference. 


A rule with only one suffix (i.e., .c:) is the definition of how to build x 
from x.c. In effect, the other suffix is null. This is useful for building 
targets from only one source file (e.g., shell procedures, simple C 
programs). 


Additional suffixes are given as the dependency list for .SUFFIXES. 
Order Is significant; the first possible name for which both a file and 
a rule exist is inferred as a prerequisite. The default list is: 


.SUFFIXES: .o .c -y | .s 


Here again, the above command for printing the internal rules will 
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display the list of suffixes implemented on the current machine. ~ 
Multiple suffix lists accumulate; .SUFFIXES: with no dependencie._ J 
clears the list of suffixes. 


Inference Rules 
The first example can be done more briefly. 


pgm: a.o b.o 
cc a.0 0.0 —O pgm 
a.o b.o: incl.h 


This is because make has a set of internal rules for building files. 
The user may add rules to this list by simply putting them in the 
makefile. 


Certain macros are used by the default inference rules to permit the 
inclusion of optional matter in any resulting commands. For exam- 
ple, CFLAGS , LFLAGS , and YFLAGS are used for compiler options 
to cc (1), lex (1), and yacc (1), respectively. Again, the previous 
method for examining the current rules is recommended. 


The inference of prerequisites can be controlled. The rule to create 

a file with suffix .o from a file with suffix .c is specified as an entry 
with .c.o: as the target and no dependents. Shell commands asso- 
ciated with the target define the rule for making a .o file from a.e 
file. Any target that has no slashes in it and starts with a dot is. / 
identified as a rule and not a true target. 


Libraries 
If a target or dependency name contains parentheses, it is assumed 
to be an archive library, the string within parentheses referring to a 
member within the library. Thus lib(file.o) and $(LIB)(file.o) both 
refer to an archive library which contains file.o. (This assumes the 
LIB macro has been previously defined.) The expression 
$(LIB)(file1.o file2.0) is not legal. Rules pertaining to archive 
libraries have the form .XX.a where the XxX is the suffix from which 
the archive member is to be made. An unfortunate byproduct of the 
current implementation requires the XxX to be different from the suffix 
of the archive member. Thus, one cannot have lib(file.o) depend 
upon file.o explicitly. The most common use of the archive inter- 
face follows. Here, we assume the source files are all C type 


source: 
lib: lib(file1.0) lib(file2.0) lib(file3.o) 
«echo lib is now up-to-date 
.C.a: oe 
$(CC) -c $(CFLAGS) $< —_— 
ar rv $«@ $*.0 Me 
rm -f $*.0 
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dee In fact, the .c.a rule listed above is built into make and is unneces- 
( sary in this example. A more interesting, but more limited example 
of an archive library maintenance construction follows: 


lib: lib(file1.0) lib(file2.0) lib(file3.o) 
$(CC) -c $(CFLAGS) $(?:.0=.c) 
ar rv lib $? | 
rm $? («echo lib is now up-to-date 
C.al; 


Here the substitution mode of the macro expansions is used. The 
$? list is defined to be the set of object file names (inside lib) 
whose C source files are out-of-date. The substitution mode 
translates the .o to .c. (Unfortunately, one cannot as yet transform 
to .c ; however, this may become possible in the future.) Note also, 
the disabling of the .c.a: rule, which would have created each object 
file, one by one. This particular construct speeds up archive library 
maintenance considerably. This type of construct becomes very 
cumbersome if the archive library contains a mix of assembly pro- 
grams and C programs. 


FILES 
[Mmlakefile and s.[Mmlakefile 


( : SEE ALSO 
a cce(1), ed(1), lex(1), sh(1), yacc(1). . 
printf(3S), sccsfile(4) in the Sys5 UNIX Programmer Reference 


Manual. 


BUGS 
Some commands return non-zero status inappropriately; use —i to 
overcome the difficulty. File names with the characters = : @ will 
not work. Commands that are directly executed by the shell, not- 
ably cd (7), are ineffectual across new-lines in make . The syntax 
(lib(file1.o file2.o file3.o) is illegal. You cannot build lib(file.o) 
from file.o. The macro $(a:.0=.c’) does not work. 
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NAME 


makekey — generate encryption key 


SYNOPSIS 


/usr/lib/makekey 


DESCRIPTION 


Makekey improves the usefulness of encryption schemes depend- 
ing on a key by increasing the amount of time required to search the 
key space. It reads 10 bytes from its standard input, and writes 13 
bytes on its standard output. The output depends on the input in a 
way intended to be difficult to compute (i.e., to require a substantial 
fraction of a second). 


The first eight input bytes (the input key ) can be arbitrary ASCII 
characters. The last two (the sa/t ) are best chosen from the set of 
digits, . , / , and upper- and lower-case letters. The salt characters 
are repeated as the first two characters of the output. The remain- 
ing 11 output characters are chosen from the same set as the salt 
and constitute the output key . 


The transformation performed is essentially the following: the salt is 
used to select one of 4,096 cryptographic machines all based on the 
National Bureau of Standards DES algorithm, but broken in 4,096 


different ways. Using the input key as key, a constant string is fed: 


into the machine and recirculated a number of times. The 64 bits 
that come out are distributed into the 66 oufput key bits in the 
result. 


Makekey is intended for programs that perform encryption (e.g., ed 
(1) and crypt (7)). Usually, its input and output will be pipes. 


SEE ALSO 
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crypt(1), ed(1). 
passwd(4) in the Sys5 UNIX Programmer Reference Manual. 
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~. NAME 
( man — print entries in this manual 


_ SYNOPSIS 
man [ options | [ section | titles 


DESCRIPTION 
Man locates and prints the entry of this manual named fitle in the 
specified section . (For historical reasons, the word “page” is often 
used as a synonym for “entry’ in this context.) The title is entered 
in lower case. The section number may not have a letter suffix. If 
no section is specified, the whole manual is searched for title and 
all occurrences of it are printed. Options and their meanings are: 


—Tterm Print the entry as appropriate for terminal type term . 
For a list of recognized values of term , type help 
term2 . The default value of term is 450. 

—W Print on the standard output only the path names of the 
entries, relative to /usr/catman , or to the current direc- 
tory for —d option. 


-d Search the current directory rather than /usr’catman ; 
requires the full file name (e.g., cu.1e , rather than just 
cu ). 3 

—C Causes man to invoke col (7); note that co/ (7) Is 


invoked automatically by man unless ferm is one of 300 
, 300s , 450 , 37 , 4000a , 382 , 4014 , tek , 1620 , and 
X. 


Man examines the environment variable $TERM (see environ (5)) 
and attempts to select options that adapt the output to the terminal 
being used. The —Tterm option overrides the value of $TERM ; in 
particular, one should use —Tlp when sending the output of man to 
a line printer. 


Section may be changed before each title . 
As an example: 
man man 


would reproduce on the terminal this entry, as well as any other 
entries named man that may exist in other sections of the manual. 


FILES 
/usricatman/?_mani:man{1-8]/* Preformatted manual entries 


SEE ALSO 
term(5) in the Sys5 UNIX Programmer Reference Manual. 


Y 
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CAVEAT ca 
The man command prints manual entries that were formatted by - 
nroff when the UNIX system was installed. Entries are originally for- ~~ ~ 
matted with terminal type 37 , and are printed using the correct ter- 
minal filters as derived from the —Tterm and $TERM settings. 
Typesetting or other non-standard printing of manual entries 
requires installation of the UNIX system Documenter's Workbench. 
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-. NAME 
| mesg — permit or deny messages 
SYNOPSIS | 
mesg [n][y] 
DESCRIPTION 


Mesg with argument n forbids messages via write (1) by revoking 
non-user write permission on the user’s terminal. Mesg with argu- 
ment y reinstates permission. All by itself, mesg reports the current 
state without changing it. 


FILES 
/ dev’tty ** 
SEE ALSO 
write(1). 


DIAGNOSTICS 
Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME a 
mkdir — make a directory : 


SYNOPSIS 
mkdir dirname . 


DESCRIPTION : 
Mkdir creates specified directories in mode 777 (possibly altered by 
umask (1)). Standard entries, . , for the directory itself, and .. , for 
its parent, are made automatically. 


Mkdir requires write permission in the parent directory. 


SEE ALSO 
sh(1), rm(1), umask(1). 


DIAGNOSTICS 
Mkair returns exit code 0 if all directories were successfully made; 
otherwise, it prints a diagnostic and returns non-zero. 
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NAME 

mkstr — create an error message file by massaging C source 
SYNOPSIS 

/usr/pIx/mkstr [ — ] messagefile prefix file ... 
DESCRIPTION 7 


Mkstr is used to create files of error messages. Its use can reduce 
the size of programs with large numbers of error diagnostics. It can 
also reduce system overhead in running the program, since the 
error messages do not have to be constantly swapped in and out. 


Mkstr will process each of the specified files, placing a massaged 
version of the input file in a file whose name consists of the speci- 
fied prefix and the original name. A typical usage of mkstr would be 


mkstr pistrings xx *.c 


This command would cause all the error messages from the C 
source files in the current directory to be placed in the file pistrings 
and processed copies of the source for these files to be placed in 
files whose names are prefixed with xx. 


To process the error messages in the source to the message file 
mkstr keys on the string ‘error(’” in the input stream. Each time it 
occurs, the C string starting at the "” is placed in the message file 
followed by a null character and a new-line character; the null char- 
acter terminates the message so it can be easily used when 
retrieved, and the new-line character makes it possible to sensibly 
cat the error message file to see its contents. The massaged copy 
of the input file then contains a /seek pointer into the file. The 
pointer can then be used to retrieve the message, I.e.: 


char efilname[] = “usr lib. pi_strings”; 
int efil = -1; 


error(al, a2, a3, a4) 


{ 
char buf[256}; 
if (efil < Q) { 
efil = open(efilname, 0); 
if (efil < 0) { 
oops: 
perror(efilname); 
exit(1); 
j 
} 
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if (Iseek(efil, (long) at, 0) lread(efil, buf, 256)<=0) —~ 
goto oops: . 
printf(buf, a2, a3, a4); oe 
i 
The optional — causes the error messages to be placed at the end 
of the specified message file for recompiling part of a large mkstr ed 


program. 


NOTES 
This program is based on a similar one from the University of Cali- 


fornia at Berkeley. 


SEE ALSO 
lseek(2), xstr(1) 


BUGS 
All the arguments except the name of the file to be processed are 


unnecessaly. 
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NAME 


mm, osdd, checkmm — print/check documents formatted with the 
MM macros 


SYNOPSIS 
mm [ options ] [ files ] 


} 


osdd [ options ] [ files ] 
checkmm [| files ] 


DESCRIPTION 
Mm can be used to type out documents using nroff and the MM 
text-formatting macro package. It has options to specify prepro- 
cessing by tb/(1) and/or neqn (see eqn(1)) and postprocessing by | 
various terminal-oriented output filters. The proper pipelines and the 
required arguments and flags for nroff and MM are generated, 
depending on the options selected. 


Osdd is equivalent to the command mm —mosd. For more informa- 
tion about the OSDD adapter macro package, see mosd(5). 


Options for mm are given below. Any other arguments or flags 
(e.g., -rC3) are passed to nroff or to MM, as appropriate. Such 
options can occur in any order, but they must appear before the 


( files arguments. If no arguments are given, mm prints a list of its 
pS 


options. 


-Tterm Specifies the type of output terminal; for a list of recog- 
nized values for term, type help term2. If this option is 
not used, mm will use the value of the shell variable 
STERM from the environment (see profile(4) and 
environ(5)) as the value of term, if $TERM is set; other- 
wise, mm will use 450 as the value of term. If several 
terminal types are specified, the last one takes pre- 
cedence. 

—12 Indicates that the document is to be produced in 12-pitch. 
May be used when $TERM is set to one of 300, 300s, 
450, and 1620. (The pitch switch on the DAS! 300 and 
300s terminals must be manually set to 12 if this option is 
used. ) 

—C Causes mm to invoke co/(1); note that co/(1) is invoked 
automatically by mm unless term is one of 300, 300s, 
450, 37, 4000a, 382, 4014, tek, 1620, and X. 


—e Causes mm to invoke neqn; also causes negn to read 
the /usr/pub/eqnchar file (see eqnchar(5)). 

—t Causes mm to invoke fb/(1). 

—E Invokes the —e option of nroff. 

—y Causes mm to use the non-compacted version of the 


macros (see mm(5)). | 
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As an example (assuming that the shell variable $TERM Is set in the 
environment to 450), the two command lines below are equivalent: 


mm -t -rC3 -—12 ghh« 
tbl ghh» | nroff -cm —T450--12 —h -rC3 


Mm reads the standard inout when — is specified instead of any file 
names. (Mentioning other files together with — leads to disaster.) 
This option allows mm to be used as a filter, e.g.: 


cat dws | mm — 


Checkmm is a program for checking the contents of the named files 
for errors in the use of the Memorandum Macros, missing or unbal- 
anced neqn delimiters, and .EQ/.EN pairs. Note: The user need not 
use the checkeq program (see eqn(1)). Appropriate messages are 
produced. The program skips all directories, and if no file name is 
given, standard input is read. 


1. Mm invokes nroff with the —h flag. With this flag, nroff 
assumes that the terminal has tabs set every 8 character posi- 
tions. 

2. Use the -olist option of nroff to specify ranges of pages to be 
output. Note, however, that mm, if invoked with one or more of 


the -e, -t, and — options, together with the —olist option of nroff « 


may cause a harmless “broken pipe’ diagnostic if the last page 
of the document is not specified in /ist. 

3. If you use the —s option of nroff (to stop between pages of out- 
put), use line-feed (rather than return or new-line) to restart the 
output. The —s option of nroff does not work with the —c option 
of mm, or if mm automatically invokes co/(1) (see —c¢ option 
above). 

4. lf you lie to mm about the kind of terminal its output will be 
printed on, you will get (often subtle) garbage; however, if you 
are redirecting output into a file, use the -T37 option, and then 
use the appropriate terminal filter when you print that file. 


SEE ALSO 


col(1), env(1), eqn(1), greek(1), mmt(1), nroff(1), tbl(1), profile(4), 


~mm(5), term(5). 


Sys5S UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. 


DIAGNOSTICS 
mm “mm: no input file” if none of the arguments is a readable 
file and mm is not used as a filter. 
checkmm 
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“Cannot open filename” if file(s) is unreadable. The 
remaining output of the program is diagnostic of the 
source file. 
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mmlint — sroff/MM nroff/MM document compatibility checker 


SYNOPSIS 
mmilint —s file 
mmilint —n file 


DESCRIPTION 
Mmiint reads file (an input document) and reports the document 
changes needed to convert the document to be runnable by the text 
formatter specified by the option. 


—-s  mmiint will flag nroff/MM constructs that are illegal in sroff/MM. 
—n = mmiint will flag sroff/MM constructs that are illegal in nroff/MM. 


Constructs are commands, embedded commands, or register refer- 
ences. 


There are three types of messages: 


Equivalent messages, 
which give the equivalent construct in the target formatter. 


Non-equivalent messages, 
which indicate that there is no equivalent construct in the tar- 


( get formatter. 


Warning messages, 
which describe the different meanings of a command or argu- 
ment in each formatter. 


Messages are output on standard output. 


CAVEATS 
With the -s option, mmlint assumes the input file is in nroff/MM for- 
mat. However, if the file is in sroff/MM format, some erroneous 
messages may appear. For example, 
\(ad\(asr)): no special chars in sroff 


although this is a legal register construct in sroff. 


The same characteristic is true for the —n option, with the following 
messages: 


\(s!): use \n(sl) in nroff 
although in nroff, this is the character sequence "/)". 
( \t: use \nt in nroff 


although in nroff, \t is the tab escape sequence. 
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\(:Mu): register names can only be two characters long 
in nroff 


although :M is a legal register name in nroff. 
-SO and .nx requests are ignored by mmilint. 
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mmt, mvt — typeset documents, viewgraphs, and slides 


SYNOPSIS 


mmt [ options | [ files ] 
mvt [ options } [ files ] 


DESCRIPTION 
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These two commands are very similar to mm(1), except that they 
both typeset their input via troff(1), as opposed to formatting it via 
nroff(1); mmt uses the MM macro package, while mvt uses the 
Macro Package for View Graphs and Slides. These two commands 
have options to specify preprocessing by fb/(1) and/or pic(1) and/or 
eqn(1). The proper pipelines and the required arguments and flags 
for troff(1) and for the macro packages are generated, depending on 
the options selected. 


Options are given below. Any other arguments or flags (e.g., -rC3) 
are passed to ftroff(1) or to the macro package, as appropriate. 
Such options can occur in any order, but they must appear before 
the files arguments. If no arguments are given, these commands 
print a list of their options. 


-—e Causes these commands to invoke eqn(1); also causes 
eqn to read the /usr/pub/eqnchar file (see eqnchar(5)). 

—t Causes these commands to invoke ftb/(1). 

—p Invokes pic(1). 

—Taps Creates output for an Autologic APS-5 phototypesetter, 
and sends it to the default destination at this installation. 

—Tdest Creates output for troff device dest (see troff(1)). The 
output is sent through the appropriate postprocessor. 

-—Tcat Uses otroff(1) to generate output for an on-line Wang 
CAT phototypesetter. 

-—D4014 Directs the output to a TEKTRONIX 4014 terminal via the 

| tc(1) filter. 

—Dtek Same as —D4014. 

—Di10 Directs the output to the local Imagen Imprint-10 laser 
printer. 

—a Invokes the ~—a option of troff(1). 

-y Causes mmt to use the non-compacted version of the 
macros. This is the default except when using —Tcat. 

—z Invokes no output filter to process or redirect the output 


of troff(1). 


These commands read the standard input when — is specified 
instead of any file names. 


Mvt is just a link to mmt. 
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HINT . 
Use the —olist option of troff(1) to specify ranges of pages to be out- / 


more of the -e, —-t, and — options, togefher with the —olist option of 
troff(1) may cause a harmless “broken pipe” diagnostic if the last 
page of the document is not specified in /ist. 


SEE ALSO 
env(1), eqn(1), mm(1), nroff(1), pic(1), tbl(1), tc(1), troff(1), pro- 
file(4), environ(5), mm(5), mv(5). 


DIAGNOSTICS 
“m[mv]t: no input file” if none of the arguments is a readable file 
and the command is not used as a filter. 
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nroff, otroff — format or typeset text 


nroff [ options | [ files | 


otroff [ options | [ files | 


DESCRIPTION 
Nroff formats text contained in files (standard input by default) for 
printing on typewriter-like devices and line printers; similarly, otroff 
formats text for a Wang Laboratories, Inc., C/A/T phototypesetter. 
Their capabilities are described in the NROFF/TROFF User Manual 
cited below. 


An argument consisting of a minus (-) is taken to be a file name 
corresponding to the standard input. The options, which may 
appear in any order, but must appear before the files, are: 


—olist 


—nN 
—SN 


—raN 


Print only pages whose page numbers appear in the /ist 
of numbers and ranges, separated by commas. A range 
N-M means pages N through M; an initial -N means 
from the beginning to page N; and a final N— means from 
N to the end. (See BUGS below.) 

Number first generated page N. 

Stop every N pages. WNroff will halt after every N pages 
(default N=1) to allow paper loading or changing, and will 
resume upon receipt of a line-feed or new-line (new-lines 
do not work in pipelines, e.g., with mm(1)). This option 
does not work if the output of nroff is piped through 
col(1). Oftroff will stop the phototypesetter every N 
pages, produce a trailer to allow changing cassettes, and 
resume when the typesetters start button is pressed. 
When nroff (otroff) halts between pages, an ASCII BEL (in 
otroff, the message page stop) is sent to the terminal. 
Set register a (which must have a one-character name) to 
N. 

Read standard input after files are exhausted. 

Invoke the simultaneous input-output mode of the .rd 
request. 

Print only messages generated by .tm (terminal mes- 
sage) requests. 

Prepend to the input files the non-compacted (ASCIi text) 
macro file /usr/ib/tmac/tmac.name. 

Prepend to the input files the compacted macro files 
/usr/lib/macros/cmp.[ nt }.[ dt ].name and 
/usr/lib/macros/ucmp.[ nt J.name. 

Compact the macros used in this invocation of 
nroff/otroff, placing the output in files [dt].name in the 


September 18, 1986 


NROFF(1) 


Nroff only: 


Otroff only: 


FILES 


UNIX Sys5 NROFF(1) 


current directory (see the NROFF/TROFF User Manual for 
details of compacting macro files). 


—Tname 


—e 


—h 


—t 


—f 


—Tcat 


Prepare output for specified terminal. Known names are 37 
for the (default) TELETYPE® Model 37 terminal, tn300 for 
the GE TermiNet 300 (or any terminal without half-line capa- 
bility), 300s for the DAS! 300s, 300 for the DAS! 300, 450 for 
the DAS! 450, Ip for a (generic) ASCH line c.inter, 382 for the 
DTC-382, 4000A for the Trendata 4000A, 832 for the Ander- 
son Jacobson 832, X for a (generic) EBCDIC printer, and 
2631 for the Hewlett Packard 2631 line printer. 


Produce equally-spaced words in adjusted lines, using the 
full resolution of the particular terminal. 


Use output tabs during horizontal spacing to speed output 
and reduce output character count. Tab settings are 


- assumed to be every 8 nominal character widths. 


Set the emboldening factor (number of character over- 
strikes) for the third font position (bold) to n, or to zero if n 
is missing. 


Direct output to the standard output instead of the photo- 
typesetter. 


Refrain from feeding out paper and stopping phototypesetter 
at the end of the run. 


Wait until phototypesetter is available, if it is currently busy. 


Report whether the phototypesetter is busy or available. No 
text processing is done. 


send a printable ASCII approximation of the results to the 
standard output. 


Print all characters in point size N while retaining all 
prescribed spacings and motions, to reduce phototypesetter 
elapsed time. 


Use font-width tables for Wang CAT phototypesetter. This 
device is both the default and the only choice. 


/usr/lib/suftab suffix hyphenation tables 


ftmp/ta$# temporary file 
fusr/lib/tmac/tmac.* standard macro files and pointers 
/usr/lib/macros/* standard macro files 


fusr/lib/term/* terminal driving tables for nroff 
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/usr/lib/font/* font width tables for otroff 


eqn(1), ocw(1), tbl(1), mm(5). 


nroff only- 
col(1), greek(1), mm(1). 


otroff only- 
mmt(1), mv(5). 


Nroff/otroff believes in Eastern Standard Time; as a result, depend- 
ing on the time of the year and on your local time zone, the date 
that nroff/otroff generates may be off by one day from your idea of 
what the date is. 


When nroff/otroff is used with the —olist option inside a pipeline 
(e.g., with one or more of ocw(1), eqn(1), and fb/(1)), it may cause 
a harmless “broken pipe” diagnostic if the last page of the docu- 
ment is not specified in list. 
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NAME 
ocw, checkcw — prepare constant-width text for otroff a a 
SYNOPSIS ea 
ocw [ -lxx ] [ -rxx ] [ -fn J] [ -t ] [ +t] [ -d] [ files ] 
checkcw [ -Ixx ] [ -rxx | files 
DESCRIPTION 

Ocw is a preprocessor for otroff (see nroff(1)) input files that con- 

tain text to be typeset in the constant-width (CW) font on the Wang 

CAT phototypesetter. This preprocessor is not necessary for users 

of the new device-independent troff(1), nor is it compatible with it. 

Refer to the Addendum to the NROFF/TROFF User Manual for 

details on how to eliminate the use of this command. 

Text typeset with the CW font resembles the output of terminals and 

of line printers. This font is used to typeset examples of programs 

and of computer output in user manuals, programming texts, etc. 

(An earlier version of this font was used in typesetting The C Pro- 

gramming Language by B. W. Kernighan and D. M. Ritchie.) It has 

been designed to be quite distinctive (but not overly obtrusive) when 
used together with the Times Roman font. 

Because the CW font on the Wang CAT contains a “non-standard” 

set of characters and because text typeset with it requires different _ 

character and inter-word spacing than is used for “standard” fonts, — 
documents that use the CW font must be preprocessed by ocw. 

The CW font contains the 94 printing ASCII characters: 
abcdefghijklmnoparstuvwxyz 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
0123456789 
UG oR) an a Pia OT ee le 

plus eight non-ASCII characters represented by four-character otroff 

names (in some cases attaching these names to “non-standard” 

graphics): 
Character Symbol _Troff Name 

“Cents” sign ¢ \(ct 

EBCDIC “not” sign ~ \(no 

Left arrow - \(<- 

Right arrow > \(-> 

Down arrow \ \(da 

Vertical single quote \(fm 
Control-shift indicator ie \(dg ma 

Visible space indicator a \(sq a 

Hyphen - \(hy —_ 
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The hyphen is a synonym for the unadorned minus sign ( - ). Cer- 
tain versions of ocw recognize two additional names: \ (ua for an 
up arrow and \ (Ih for a diagonal left-up (home) arrow. 


Ocw recognizes five request lines, as well as user-defined delim- 
iters. The request lines look like otroff macro requests, and are 
copied in their entirety by ocw onto its output; thus, they can be 
defined by the user as otroff macros; in fact, the .CW and .CN mac- 
ros should be so defined (see HINTS below). The five requests are: 


.CW Start of text to be set in the CW font; .CW causes a break; it 
can take precisely the same options, in precisely the same 
format, as are available on the ocw command line. 


.CN End of text to be set in the CW font; .CN causes a break; it 
can take the same options as are available on the ocw 
command line. 


-CD Change delimiters and/or settings of other options; takes the 
same options as are available on the ocw command line. 


CP arg! arg2 args ... argn 
All the arguments (which are delimited like ofroff macro 
arguments) are concatenated, with the odd-numbered argu- 
ments set in the CW font and the even-numbered ones in 
the prevailing font. 


-PC arg? arg2 arg3 ... argn 
Same as .CP, except that the even-numbered arguments 
are set in the CW font and the odd-numbered ones in the 
prevailing font. 


The .CW and .CN requests are meant to bracket text (e.g., a pro- 
gram fragment) that is to be typeset in the CW font “as is.” Nor- 
mally, ocw operates in the transparent mode. In that mode, except 
for the .CD request and the nine special four-character names listed 
in the table above, every character between .CW and .CN request 
lines stands for itself. In particular, ocw arranges for periods ( .) 
and apostrophes (’ ) at the beginning of lines, and backslashes ( \ ) 
everywhere to be “hidden” from otroff. The transparent mode can 
be turned off (see below), in which case normal otroff rules apply; in 
particular, lines that begin with . and ° are passed through 
untouched (except if they contain delimiters—see below). In either 
case, ocw hides the effect of the font changes generated by the 
-CW and .CN requests; ocw also defeats all ligatures (fi, ff, etc.) in 
the CW font. 


The only purpose of the .CD request is to allow the changing of vari- 
Ous options other than just at the beginning of a document. 


The user can also define delimiters. The left and right delimiters 
perform the same function as the .CW/.CN requests; they are 
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HINTS 
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meant, however, to enclose CW “words” or “phrases” in running text 


(see example under BUGS below). Ocw treats text between delim- | . 
iters in the same manner as text enclosed by .CW/.CN pairs, © 


except that, for aesthetic reasons, spaces and backspaces inside 
-CW/.CN pairs have the same width as other CW characters. 
While spaces and backspaces between delimiters are half as wide, 
so they have the same width as spaces in the prevailing text (but 
are not adjustable). Font changes due to delimiters are not hidden. 


Delimiters have no special meaning inside .CW/.CN pairs. 
The options are: 


“1xx The one- or two-character string xx becomes the left delim- 
iter; if xx is omitted, the left delimiter becomes undefined, 
which it ts initially. 

-+rxx Same for the right delimiter. The left and right delimiters 
may (but need not) be different. 


-frn The CW font is mounted in font position n; values for n are 
1, 2, and 3 (default is 3, replacing the bold font). This 
option is only useful at the beginning of a document. 


-t Turn transparent mode off. 
+t Turn transparent mode on (this is the initial default). 
-d Print current option settings on file descriptor 2 in the form 


of otroff comment lines. This option is meant for debugging. 


Ocw reads the standard input when no files are specified (or when - 
is specified as the last argument), so it can be used as a filter. Typ- 
ical usage is: ocw files | otroff ... Checkcw checks that left and right 
delimiters, as well as the .CW/.CN pairs, are properly balanced. It 
prints out all offending lines. 


Typical definitions of the .CW and .CN macros meant to be used with 
the mm(5) macro package: 


.de CW 

.DS | 

.ps 9 

.VS 10.5p 

a 16m/3u 32m/3u 48m/3u 64m/38u 80m/3u 96m/3u ... 


.de CN : 

ta 0.51 11 1.51 21 2.51 3) 3.51 4) 4.5151) 5.51 61 
VS 

.ps 

.DE 
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FILES 


At the very least, the .CW macro should invoke the otroff no-fil (.nf) 
mode. 


When set in running text, the CW font is meant to be set in the same 
point size as the rest of the text. In displayed matter, on the other 
hand, it can often be profitably set one point maj/ler than the prevail- 
INg point size (the displayed definitions of .CW and .CN above are 
one point smaller than the running text on this page). The CW font 
is sized so that, when it is set in 9-point, there are 12 characters per 
inch. 


Documents that contain CW text may also contain tables and/or 
equations. If this is the case, the order of preprocessing should be: 
ocw, tbi, and eqn. Usually, the tables contained in such documents 
will not contain any CW text, although it is entirely possible to have 
elements of the table set in the CW font; of course, care must be 
taken that fb/(1) format information not be modified by ocw. 
Attempts to set equations in the CW font are not likely to be either 
pleasing or successful. 


In the CW font, overstriking is most easily accomplished with back- 
spaces: letting <- represent a backspace, d-+-\(dg yields — d. 
(Because backspaces are half as wide between delimiters as inside 
.CW/.CN pairs—see above—two backspaces are required for each 
overstrike between delimiters.) 


/usr/lib/font/ftCW = CW font-width table 


SEE ALSO 


eqn(1), nroff(1), tbl(1), mm(5), mv(5). 


WARNINGS 


BUGS 


If text preprocessed by ocw is to make any sense, it must be set on 
a typesetter equipped with the CW font or on a STARE facility; on the 
latter, the CW font appears as bold, but with the proper CW spacing. 


Only a masochist would use periods (.), backslashes (\), or double 
quotes (") as delimiters, or as arguments to .CP and .PC. 

Certain CW characters do not concatenate gracefully with certain 
Times Roman characters, e.g., a CW ampersand (&) followed by a 
Times Roman comma(,). In such cases, judicious use of otroff half- 
and quarter-spaces (\{ and \’) is most salutary, e.g., one should use 
_&_\’, (rather than just plain _&_,) to obtain &, (assuming that _ is 
used for both delimiters). 

Using ocw with nroff is silly. 

The output of ocw is hard to read. 

See also BUGS under nroff(1). 
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NAME 
more, page — file perusal filter for crt viewing 
SYNOPSIS 
/usr/pix’more [ -d ] [ -f ] [ -l ] [ -n ] [ +linenumber | [ +/pat- 


tern | [ name... ] 


page [-d][-f][-lI][- ] +linenumber | [ +/pattern ] [ 
name... | 


DESCRIPTION 
More is a filter that allows examination of a continuous text one 
screenful at a time on a soft-copy terminal. It normally pauses after 
each screenful, printing --More-- at the bottom of the screen. If the 
user then types a carriage return, one more line is displayed. If the 
user hits a space, another screenful is displayed. Other possibilites 
are enumerated later. 


The command line options are: 


—n An integer that is the size (in lines) of the window that more 
will use instead of the default. 


-d More will prompt the user with the message "Hit space to 
continue, Rubout to abort" at the end of each screenful. 
This is useful if more is being used as a filter in some Set- 
ting, such as a class, where many users may be unsophisti- 
cated. 


—f This causes more to count logical, rather than screen lines. 
That is, long lines are not folded. This option is recom- 
mended if nroff output is being piped through ul, since the 
latter may generate escape sequences. These escape 
sequences contain characters which would ordinarily occupy 
screen postions, but which do not print when they are sent 
to the terminal as part of an escape sequence. Thus more 
may think that lines are longer than they actually are, and 
fold lines erroneously. 


—| Do not treat “L (form feed) specially. If this option is not 
given, more will pause after any line that contains a ‘L, as if 
the end of a screenful had been reached. Also, if a file 
begins with a form feed, the screen will be cleared before 
the file is printed. 


+ finenumber 
Start up at finenumber. 


+ /pattern 
Start up two lines before the line containing the regular 
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expression pattern. 2 i a 


If the program is invoked as page, then the screen is cleared before > 


each screenful is printed (but only if a full screenful is being printed), 

and k — 1 rather than k — 2 lines are printed in each screenful, 

where k is the number of lines the terminal can display. 

More looks in the file /etc’‘termcap to determine terminal charac- 

teristics, and to determine the default window size. On a terminal 

capable of displaying 24 lines, the default window size is 22 lines. 

If more is reading from a file, rather than a pipe, then a percentage 

is displayed along with the --More-- prompt. This gives the fraction 

of the file (in characters, not lines) that has been read so far. 

Other sequences which may be typed when more pauses, and their 

effects, are as follows (/ is an optional integer argument, defaulting 

to 1): 

i<space> 
display / more lines, (or another screenful if no argument is 
given) 3 

‘D display 11 more lines (a “scroll’). If / is given, then the 
scroll size is set to /. | —— 

d same as ‘D (control-D) | -_ 

iz same as typing a space except that /, if present, becomes 
the new window size. 

is skip / lines and print a screenful of lines 

if skip / screenfuls and print a screenful of lines 

qorQ Exit from more. 

= Display the current line number. 

V Start up the editor vi at the current line. 

h Help command; give a description of ail the more com- 
mands. | 

i/expr search for the /-th occurrence of the regular expression 
expr. \|f there are less than / occurrences of expr, and the 
input is a file (rather than a pipe), then the position in the file 
remains unchanged. Otherwise, a screenful is displayed, 
Starting two lines before the place where the expression 
was found. The users erase and kill characters may be 
used to edit the regular expression. Erasing back past the wan 


first column cancels the search command. 


~, 


me * 
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in search for the /-th occurrence of the last regular expression 
entered. 


(single quote) Go to the point from which the last search 
started. If no search nas been performed in the current file, 
this command goes back to the beginning of the file. 


lcommand 
invoke a shell with command. The characters ‘%’ and ‘!’ in 
“command” are replaced with the current file name and the 
previous shell command respectively. If there is no current 
file name, ‘% is not expanded. The sequences '\%" and "\!" 
are replaced by "%" and "!" respectively. 


iin skip to the /-th next file given in the command line (skips to | 
last file if n doesn't make sense) 


i:p skip to the /-th previous file given in the command line. If 
this command is given in the middle of printing out a file, 
then more goes back to the beginning of the file. If / doesn't 
make sense, more skips back to the first file. If more is not 
reading from a file, the bell is rung and nothing else hap- 
pens. 


‘f display the current file name and line number. 
:q or :Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 


The commands take effect immediately, i.e., it is not necessary to 
type a carriage return. Up to the time when the command character 
itself is given, the user may hit the line kill character to cancel the 
numerical argument being formed. In addition, the user may hit the 
erase character to redisplay the --More--(xx%) message. 


At any time when output is being sent to the terminal, the user can 
hit the quit key (normally control—\). More will stop sending output, 
and will display the usual --More-- prompt. The user may then enter 
one of the above commands in the normal manner. Unfortunately, 
some output is lost when this is done, due to the fact that any char- 
acters waiting in the terminal’s output queue are flushed when the 
quit signal occurs. 


The terminal is set to noecho mode by this program so that the out- 
put can be continuous. What you type will thus not show on your 
terminal, except for the - and | commands. 


lf the standard output is not a teletype, then more acts just like cat, 
except that a header is printed before each file (if there is more than 
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one). joes. 
A sample usage of more in previewing nroff output would be oa 


nroff -ms +2 doc.n| more 


FILES 
/etc/termcap Terminal data base 
/usr: lib: more.help Help file 
NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 
SEE ALSO 


script(1) 
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NAME 


newform — change the format of a text file 


SYNOPSIS 


newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] 
[-f] [-cchar] [-In] [files ] 


DESCRIPTION 


Page 1 


Newform reads lines from the named files , or the standard input if 
no input file is named, and reproduces the lines on the standard out- 
put. Lines are reformatted in accordance with command line 
options in effect. 


Except for -s , command line options may appear in any order, may 
be repeated, and may be intermingled with the optional files . Com- 
mand line options are processed in the order specified. This means 
that option sequences like “-e15 —I 60” will yield results different 
from “-I60 -e 15’’. Options are applied to all files on the command 
line. 


-iftabspec Input tab specification: expands tabs to spaces, accord- 
ing to the tab specifications given. Tabspec recognizes 
all tab specification forms described in tabs (7). In addi- 
tion, tabspec may be — , in which newform assumes 
that the tab specification is to be found in the first line 
read from the standard input (see fspec (4)). If no 
fabspec is given, tabspec defaults to -8 . A tabspec of 
-—Q expects no tabs; if any are found, they are treated as 
—1. 


—otabspec 
Output tab specification: replaces spaces by tabs, 
according to the tab specifications given. The tab specif- 
ications are the same as for —ifabspec. If no tabspec is 
given, tabspec defaults to -8 . A tabspec of -0 means 
that no spaces will be converted to tabs on output. 


—In Set the effective line length to n characters. If nm is not 
entered, —-I defaults to 72. The default line length without 
the -I option is 80 characters. Note that tabs and back- 
Spaces are considered to be one character (use -i to 
expand tabs to spaces). 


—bn Truncate n characters from the beginning of the line 
when the line length is greater than the effective line 
length (see -In). Default is to truncate the number of 
characters necessary to obtain the effective line length. 
The default value is used when —b with no rn is used. 
This option can be used to delete the sequence numbers 
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-f 


-S 
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from a COBOL program as follows: 
newform —|l1 —b7 file-name 


The -l1 must be used to set the effective line length 
shorter than any existing line in the file so that the —b 
option is activated. 


Same as —bn except that characters are truncated from 
the end of the line. 


Change the’ prefix/append character to k . Default char- 
acter for k is a space. 


Prefix n characters (see —ck) to the beginning of a line 
when the line length is less than the effective line length. 


Default is to prefix the number of characters necessary © 


to obtain the effective line length. 


Same as -pn except characters are appended to the 
end of a line. 


Write the tab specification format line on the standard 
output before any other lines are output. The tab specifi- 
cation format line which ts printed will correspond to the 
format specified in the /ast —o option. If no —o option is 


specified, the line which is printed will contain the default ; 


specification of -8 . 


Shears off leading characters on each line up to the first 
tab and places up to 8 of the sheared characters at the 
end of the line. If more than 8 characters (not counting 
the first tab) are sheared, the eighth character is 
replaced by a * and any characters to the right of it are 
discarded. The first tab is always discarded. 


An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The characters 
are then added at the end of the processed line. 


For example, to convert a file with leading digits, one or 
more tabs, and text on each line, to a file beginning with 
the text, all tabs after the first expanded to spaces, pad- 
ded with spaces out to column 72 (or truncated to 
column 72), and the leading digits placed starting at 
column 73, the command would be: 

newform —s -—i -| —a -e file-name 
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DIAGNOSTICS 
All diagnostics are fatal. 
usage: 
not —s format 
can't open file 
internal line too long 


( 


tabspec in error 


tabspec indirection illegal 


EXIT CODES 
0 — normal execution 
1 — for any error 


SEE ALSO © 


| csplit(1), tabs(1). 
( - BUGS 
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Newform was called with a bad option. 
There was no tab on one line. 
Self-explanatory. 

A line exceeds 512 characters after 
being expanded in the internal work 
buffer. 

A tab specification is incorrectly format- 
ted, or specified tab stops are not 
ascending. 

A tabspec read from a file (or standard 
input) may not contain a tabspec — 
referencing another file (or standard 
input). 


fspec(4) in the Sys5 UNIX Programmer Reference Manual. 


Newform normally only keeps track of physical characters; however, 
for the -i and —o options, newform will keep track of backspaces in 
order to line up tabs in the appropriate logical columns. 


Newform will not prompt the user if a tabspec is to be read from the 
standard input (by use of -i— or -o— ). 


If the -f option is used, and the last -o option specified was —o— , 


and was preceded by either a -o— or a -i— 
format line will be incorrect. 
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NAME 


newgrp — log in to a new group 


SYNOPSIS 


newgrp [=] [ group |] 


DESCRIPTION 


Newgrp changes a user's group identification. The user remains 
logged in and the current directory is unchanged, but calculations of 
access permissions to files are performed with respect to the new 
real and effective group IDs. The user is always given a new shell, 
replacing the current shell, by newgrp , regardless of whether it ter- 
minated successfully or due to an error condition (i.e., unknown 
group). 


Exported variables retain their values after invoking newgrp ; how- 
ever, all unexported variables are either reset to their default value 
or set to null. System variables (such as PS1, PS2, PATH, MAIL, 
and HOME), unless exported by the system or explicitly exported by 
the user, are reset to default values. For example, a user has a pri- 
mary prompt string (PS1) other than $ (default) and has not 
exported PS1. After an invocation of newgrp , successful or not, 
their PS1 will now be set to the default prompt string $. Note that 
the shell command export (see sh(1)) is the method to export vari- 
ables so that they retain their assigned value when invoking new 
shells. 


With no arguments, newgrp changes the group identification back 
to the group specified in the user's password file entry. 


lf the first argument to newgrp is a — , the environment is changed 
to what would be expected if the user actually logged in again. 


A password is demanded if the group has a password and the user 
does not, or if the group has a password and the user is not listed in 
/etc/group as being a member of that group. 


FILES 
/etc/group system's group file 
/etc/passwd system's password file 
SEE ALSO 
login(1), sh(1). 
group(4), passwd(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 
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BUGS 
( There is no convenient way to enter a password into /etc/group . 
te Use of group passwords is not encouraged, because, by their very 
nature, they encourage poor security practices. Group passwords 
may disappear in the future. 
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NAME 


news — print news items | 


SYNOPSIS 


news [ -a][-—-n][-s ] [ items ] 


DESCRIPTION 


FILES 


News is used to keep the user informed of current events. By con- 
vention, these events are described by files in the directory 
/usr/news . 


When invoked without arguments, news prints the contents of all 
current files in /usr/news , most recent first, with each preceded by 
an appropriate header. News stores the “currency” time as the 
modification date of a file named .news_time in the user's home 
directory (the identity of this directory is determined by the environ- 
ment variable $HOME ); only files more recent than this currency 
time are considered “current.” 


The -a option causes news to print all items, regardless of 
Currency. In this case, the stored time is not changed. 


The —n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 


The —s option causes news to report how many current items exist, a 


without printing their names or contents, and without changing the © 
stored time. It is useful to include such an invocation of news in 
one’s .profile file, or in the system's /etc/profile . 


All other arguments are assumed to be specific news items that are 
to be printed. 


lf a delete is typed during the printing of a news item, printing stops 
and the next item is started. Another delete within one second of 
the first causes the program to terminate. 


/etc/profile 
/UST/NeWS/* 
SHOME/.news_time 


SEE ALSO 
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profile(4), environ(5) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 
nice — run a command at low priority 


SYNOPSIS 


nice [ — increment ]| command [ arguments | 


DESCRIPTION | 
Nice executes command with a lower CPU scheduling priority. If 
the increment argument (in the range 1-19) is given, it is used; if 
not, an increment of 10 is assumed. 


The super-user may run commands with priority higher than normal 
by using a negative increment, e.g., —10. 
SEE ALSO 
nohup(1). 
nice(2) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS 
Nice returns the exit status of the subject command. 


BUGS | 
An increment larger than 19 is equivalent to 19. 
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NAME 
nl — line numbering filter 


SYNOPSIS ae 
nl [-htype] [-btype] [-ftype] [-vstart#] [-tincr] [-p] [-—Inum] 
[-ssep] [-wwidth] [-nformat] [—ddelim] file =_ 


DESCRIPTION 
Ni reads lines from the named file or the standard input if no file is 
named and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 
effect. 


NI views the text it reads in terms of logical pages. Line numbering 
is reset at the start of each logical page. A logical page consists of 
a header, a body, and a footer section. Empty sections are valid. 
Different line numbering options are independently available for 
header, body, and footer (e.g., no numbering of header and footer 
lines while numbering blank lines only in the body). 


The start of logical page sections are signaled by input lines contain- 
ing nothing but the following delimiter character(s): 


Line contents _ Start of 


Rea header 
ts body 
“ footer 


Unless optioned otherwise, n/ assumes the text being read is in a 
single logical page body. 


Command options may appear in any order and may be intermin- 
gled with an optional file name. Only one file may be named. The 
options are: 


—-btype specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a , 
number all lines; t , number lines with printable text only; 
n , no line numbering; pstring, number only lines that 
contain the regular expression specified in string . 
Default type for logical page body Is t (text lines num- 
bered). 


-htype Same as -btype except for header. Default type for 
logical page header is n (no lines numbered). 


-ftype Same as —bfype except for footer. Default for logical 
page footer is n (no lines numbered). 
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—wwiadth 


—nformat 


—lnum 


—dxx 


EXAMPLE 
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Do not restart numbering at logical page delimiters. 


Start# is the initial value used to number logical page 
lines. Default is 1. 


Incr is the increment value used to number logical page 
lines. Default is 1. 


Sep is the character(s) used in separating the line 
number and the corresponding text line. Default sep is a 
tab. 


Width is the number of characters to be used for the line 
number. Default width is 6 . 


Format is the line numbering format. Recognized values 
are: In , left justified, leading zeroes suppressed; rn , 
right justified, leading zeroes supressed; rz , right justi- 
fied, leading zeroes kept. Default format is rn (right justi- 
fied). 


Num is the number of blank lines to be considered as 
one. For example, -I2 results in only the second adja- 
cent blank being numbered (if the appropriate —ha , —ba 
, andor —fa option is set). Default is 1. 


The delimiter characters specifying the start of a logical 
page section may be changed from the default charac- 
ters (\:) to two user-specified characters. If only one 
character is entered, the second character remains the 
default character (:). No space should appear between 
the -—d and the delimiter characters. To enter a 
backslash, use two backslashes. 


The command: 


nl -vi0 -—110 -d!+ filet 


will number file1 starting at line number 10 with an increment of ten. 
The logical page delimiters are !+. 


SEE ALSO 
pr(1). 
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NAME 


SYNOPSIS 
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nm — print name list of common object file 


nm [-—o] [—x] [—h] [-v] [—n] [-e] [-f] [-u] [-V] [-—T] file-names 


DESCRIPTION 


The nm command displays the symbol table of each common object 
file file-name . File-name may be a relocatable or absolute common 
object file; or it may be an archive of relocatable or absolute com- 
mon object files. For each symbol, the following information will be 


printed: 
Name 
Value 


Class 
Type 


Size 


Line 


Section 


The name of the symbol. 


lts value expressed as an offset or an address depending 
on its storage class. 


Its storage class. 


Its type and derived type. If the symbol is an instance of 
a structure or of a union then the structure or union tag 
will be given following the type (e.g., struct-tag). If the 
symbol is an array, then the array dimensions will be 
given following the type (eg., char[ n ][ m ] ). Note that 
the object file must have been compiled with the —g option 
of the cc (1) command for-this information to appear. 


Its size in bytes, if available. Note that the object file 
must have been compiled with the —g option of the cc (7) 
command for this information to appear. 


The source line number at which it is defined, if available. 
Note that the object file must have been compiled with the 
-~g option of the cc (7) command for this information to 
appear. 


For storage classes static and external, the object file sec- 
tion containing the symbol (e.g., text, data or bss). 


The output of nm may be controlled using the following options: 


—~O 
—X 


-h 


—V 
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Print the value and size of a symbol in octal instead of 
decimal. 


Print the value and size of a symbol in hexadecimal 
instead of decimal. 


Do not display the output header data. 
Sort external symbols by value before they are printed. 
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| —n Sort external symbols by name before they are printed. 
, | —e Print only external and static symbols. 
- —f Produce full output. Print redundant symbols (.text, .data 
and .bss), normally suppressed. 
—u Print undefined symbols only. 
-V Print the version of the nm command executing on the 


standard error output. 


—T By default, nm prints the entire name of the symbols 
listed. Since object files can have symbols names with an 
arbitrary number of characters, a name that is longer than 
the width of the column set aside for names will overflow 
its column, forcing every column after the name to be 
misaligned. The —T option causes nm to truncate every 
name which would otherwise overflow its column and 
place an asterisk as the last character in the displayed 
name to mark it as truncated. 


Options may be used in any order, either singly or in combination, 
and may appear anywhere in the command line. Therefore, both 
nm name -e -v and nm -ve name print the static and external 
symbols in name , with external symbols sorted by value. 


ay 
FILES 


CAVEATS 
When all the symbols are printed, they must be printed in the order 
they appear in the symbol table in order to preserve scoping infor- 
mation. Therefore, the —v and —n options should be used only in 
conjunction with the -e option. 


SEE ALSO 

as(1), cc(1), Id(1). 

a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS 


“nm: name: cannot open’ 
if name cannot be read. 


“nm: name: bad magic” 
if name is not an appropriate common object file. 


“nam: name: no symbols” 
if the symbols have been stripped from name . 
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NAME 
nohup — run a command immune to hangups and quits 


SYNOPSIS 
nohup command [ arguments | 


DESCRIPTION 
Nohup executes command with hangups and quits ignored. If out- 
put is not re-directed by the user, both standard output and standard 
error are sent to nohup.out . If nohup.out is not writable in the 
current directory, output is redirected to $HOME/nohup.out . 


EXAMPLE 
It is frequently desirable to apply nohup to pipelines or lists of com- 
mands. This can be done only by placing pipelines and command 
lists in a single file, called a shell procedure. One can then issue: 


nohup sh file 


and the nohup applies to everything in file. If the shell procedure file 
is to be executed often, then the need to type sh can be eliminated 
by giving file execute permission. Add an ampersand and the con- 
tents of file are run in the background with interrupts also ignored 
(see sh (1)): | 


‘nohup file & 
An example of what the contents of file could be is: 


tbl ofile | eqn | nroff > nfile 


SEE ALSO 
chmod(1), nice(1), sh(1). 
signal(2) in the Sys5 UNIX Programmer Reference Manual. 
WARNINGS | 
nohup command1; command2 nohup applies only to command? 
nohup (command1; commandz2) is syntactically incorrect. 


Be careful of where standard error is redirected. The following com- 
mand may put error messages on tape, making it unreadable: 


nohup cpio —o <list >/dev/rmt, 1m& 
while | 
nohup cpio —o <list >/dev/rmti1m 2>errors& 


puts the error messages into file errors . 
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_.. NAME 
( od — octal dump 
~ SYNOPSIS 

od [ —bcdox | [ file ] [[ + Joffset{ . J[ b ] ] 

DESCRIPTION : | 

Od dumps file in one or more formats as selected by the first argu- 

ment. If the first argument is missing, —o is default. The meanings 

of the format options are: 

-b Interpret bytes in octal. 

—C Interpret bytes in ASCII. Certain non-graphic characters 
appear as C escapes: null=\0, backspace =\b, form-feed—\f, — 
new-line=\n, return=\r, tab=\t; others appear as 3-digit octal 
numbers. 

—d Interpret words in decimal. 

—O Interpret words in octal. 

—X Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file 

; argument is specified, the standard input is used. 
( : The offset argument specifies the offset in the file where dumping is 


to commence. This argument is normally interpreted as octal bytes. 
If . is appended, the offset is interpreted in decimal. If b is 
appended, the offset is interpreted in blocks of 512 bytes. If the file 
argument is omitted, the offset argument must be preceded by + . 


Dumping continues until end-of-file. 


NOTES 
Plexus provides a standalone version of od in addition to the one 
that runs under Sys5. 


SEE ALSO 
adb(1). 
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NAME 


pack, pcat, unpack —- compress and expand files 


SYNOPSIS 


pack [ — | [ -f ] name... 
pcat name ... 
unpack name ... 


DESCRIPTION 
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Pack attempts to store the specified files in a Compressed form. 
Wherever possible (and useful), each input file name is replaced by 
a packed file name.z with the same access modes, access and 
modified dates, and owner as those of name . The -f option will 
force packing of name . This is useful for causing an entire directory 
to be packed even if some of the files will not benefit. If pack is 
successful, name will be removed. Packed files can be restored to 
their original form using unpack or pcat . 


Pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the - argument is used, an internal flag is set that causes 
the number of times each byte ts used, its relative frequency, and 
the code for the byte to be printed on the standard output. Addi- 
tional occurrences of — in place of name will cause the internal flag 
to be set and reset. 


The amount of compression obtained depends on the size of the 
input file and the character frequency distribution. Because a 
decoding tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the char- 
acter frequency distribution is very skewed, which may occur with 
printer plots or pictures. 


Typically, text files are reduced to 60-75% of their original size. 
Load modules, which use a larger character set and have a more 
uniform distribution of characters, show little compression, the 
packed versions being about 90% of the original size. 


Pack returns a value that is the number of files that it failed to 
compress. 


No packing will occur if: 


the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 
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a file called name.z already exists; 
the .z file cannot be created: 
an I/O error occurred during processing. 


The last segment of the file name must contain no more than 12 
characters to allow space for the appended .z extension. Direc- 
tories cannot be compressed. 


Pcat does for packed files what cat (1) does for ordinary files, 
except that pcat can not be used as a filter. The specified files are 
unpacked and written to the standard output. Thus to view a 
packed file named name.z use: 


pcat name.z 
or just: 
pcat name 


To make an unpacked copy, say nnn , of a packed file named 
name.z (without destroying name.z) use the command: 


pcat name =nnn 


Pcat returns the number of files it was unable to unpack. Failure 
may occur if: 


the file name (exclusive of the .z ) has more than 12 char- 
acters; 

the file cannot be opened; 

the file does not appear to be the output of pack . 


Unpack expands files created by pack . For each file name speci- 
fied in the command, a Search is made for a file called name.z (or 
just name , if name ends in .z ). If this file appears to be a packed 
file, it is replaced by its expanded version. The new file has the .z 
suffix stripped from its name, and has the same access modes, 
access and modification dates, and owner as those of the packed 
file. 


Unpack returns a value that is the number of files it was unable to 
unpack. Failure may occur for the same reasons that it may in pcat 
, aS well as for the following: 


a file with the “unpacked” name already exists; 
if the unpacked file cannot be created. 


SEE ALSO 
cat(1). 
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NAME 


passwd — change login password 


SYNOPSIS 


passwd [ name | 


DESCRIPTION 
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This command changes or installs a password associated with the 
login name . 


Ordinary users may change only the password which corresponds 
to their login name . 


Passwd prompts ordinary users for their old password, if any. It 
then prompts for the new password twice. The first time the new 
password is entered passwd checks to see if the old password has 
“aged” sufficiently. If “aging” is insufficient the new password is 
rejected and passwd terminates; see passwd (4). 


Assuming “aging” is sufficient, a check is made to insure that the 
new password meets construction requirements. When the new 
password is entered a second time the two copies of the new pass- 
word are compared. If the two copies are not identical the cycle of 
prompting for the new password is repeated for at most two more 
times. 


Passwords must be constructed to meet the following requirements: 


Each password must have at least six characters. Only the 
first eight characters are significant. 


Each password must contain at least two alphabetic charac- 
ters and at least one numeric or special character. In this 
case, ‘alphabetic’ means upper and lower case letters. 


Each password must differ from the user’s login name and 
any reverse or circular shift of that login name . For com- 
parison purposes, an upper case letter and its correspond- 
ing lower case letter are equivalent. 


New passwords must differ from the old by at least three 
characters. For comparison purposes, an upper case letter 
and its corresponding lower case letter are equivalent. 


One whose effective user ID is zero is called a super-user; see id 
(1), and su (1). Super-users may change any password; hence, 
passwd does not prompt super-users for the old password. Super- 
users are not forced to comply with password aging and password 
construction requirements. A super-user can create a null password 
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| by entering a carriage return in response to the prompt for a new 
; password. 
FILES 

/etc/passwd 


SEE ALSO 
login(1), id(1), su(1). 
crypt(3C), passwd(4) in the Sys5 UNIX Programmer Reference 
Manual. 


C 
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NAME | | _ : 
paste — merge same lines of several files or subsequent lines of one | 


\ 


file eo? 


SYNOPSIS 
paste file1 file2 ... 
paste —dlist file1 file2 ... 
paste —s [-—dlist] file1 file2 ... 


DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the 
given input files file? , file2 , etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel 
merging). If you will, it is the counterpart of cat (7) which concaten- 
ates vertically, i.e., one file after the other. In the last form above, 
paste replaces the function of an older command with the same 
name by combining subsequent lines of the input file (serial merg- 
ing). In all cases, lines are glued together with the tab character, or 
with characters from an optionally specified list . Output is to the 
standard output, so it can be used as the start of a pipe, or as a 
filter, if — is used in place of a file name. 


ee 


The meanings of the options are: 


—d Without this option, the new-line characters of each but the © 
last file (or last line in case of the -s option) are replaced by ~_- 
a tab character. This option allows replacing the fab char- 
acter by one or more alternate characters (see below). 


list One or more characters immediately following —d replace 
the default tab as the line concatenation character. The list 
is used circularly, t.e., when exhausted, it is reused. In 
parallel merging (i.e., no —s option), the lines from the last 
file are always terminated with a new-line character, not 
from the fist . The list may contain the special escape 
sequences: \n (new-line), \t (tab), \\ (backslash), and \0 
(empty string, not a null character). Quoting may be neces- 
sary, if characters have special meaning to the shell (e.g., 
to get one backslash, use —d'"\\\\" ). 


-S Merge subsequent lines rather than one from each input file. 
Use tab for concatenation, unless a /ist is specified with —d 
option. Regardless of the /ist , the very last character of the 
file is forced to be a new-line. 


_ May be used in place of any file name, to read a line from 
the standard input. (There is no prompting). a 
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EXAMPLES 


( | Is | paste -d"" - 


Is | paste - —- — - 

paste -s —d'\t\n" file 
SEE ALSO 

cut(1), grep(1), pr(1). 


DIAGNOSTICS 
line too long 


too many files 
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list directory in one column 
list directory in four columns 


combine pairs of lines into lines 


Output lines are restricted to 
511 characters. | 


Except for —s option, no more © 
than 12 input files may be 
specified. 
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pg — file perusal filter for soft-copy terminals 


SYNOPSIS 


pg [-number] [-p string] [-cefns] [+/linenumber] [+/pattern/] [ 
files ...] 


DESCRIPTION 
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The pg command is a filter which allows the examination of files 
one screenful at a time on a soft-copy terminal. (The file name — 
and/or NULL arguments indicate that pg should read from the stan- 
dard input.) Each screenful is followed by a prompt. If the user 
types a carriage return, another page is displayed; other possibilities 
are enumerated below. 


This command is different from previous paginators in that it allows 
you to back up and review something that has already passed. The 
method for doing this is explained below. 


In order to determine terminal attributes, pg scans the terminfo (4) 
data base for the terminal type specified by the environment vari- 
able TERM . If TERM is not defined, the terminal type dumb is 
assumed. 


The command line options are: 


—number 
An integer specifying the size (in lines) of the window that 
pg is to use instead of the default. (On a terminal contain- 
ing 24 lines, the default window size Is 23). 


—p string 
Causes pg to use string as the prompt. If the prompt string 
contains a “%d", the first occurrence of “%d" in the prompt 
will be replaced by the current page number when the 
prompt is issued. The default prompt string is °:”. 


—C Home the cursor and clear the screen before displaying 
each page. This option is ignored if clear_screen is not 
defined for this terminal type in the terminfo (4) data base. 


—e Causes pg not to pause at the end of each file. 


—f Normally, pg splits lines longer than the screen width, but 
some sequences of characters in the text being displayed 
(e.g., escape sequences for underlining) generate undesir- 
able results. The —f option inhibits pg from splitting lines. 


—n Normally, commands must be terminated by a <newline > 
character. This option causes an automatic end of com- 
mand as soon as a command letter is entered. 
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-s Causes pg to print all messages and prompts in standout 
mode (usually inverse video). 


+ linenumber 
Start up at /inenumber . 


+/pattern/ 
Start up at the first line containing the regular expression 
pattern. 


The responses that may be typed when pg pauses can be divided 
Into three categories: those causing further perusal, those that 
search, and those that modify the perusal environment. 


Commands which cause further perusal normally take a preceding 
address , an optionally signed number indicating the point from 
which further text should be displayed. This address is interpreted 
in either pages or lines depending on the command. A signed 
address specifies a point relative to the current page or line, and an 
unsigned address specifies an address relative to the beginning of 
the file. Each command has a default address that is used if none 
is provided. 


The perusal commands and their defaults are as follows: 
(+ 1)<newline > or <blank> 


This causes one page to be displayed. The address is 
specified in pages. 


(+1)! With a relative address this causes pg to simulate scrolling 
the screen, forward or backward, the number of lines speci- 
fied. With an absolute address this command prints a 
screenful beginning at the specified line. 

(+1) dor*D 
Simulates scrolling half a screen forward or backward. 


The following perusal commands take no address . 


. or “L 
| Typing a single period causes the current page of text to be 
redisplayed. 
$ Displays the last windowful in the file. Use with caution 


when the input is a pipe. 


The following commands are available for searching for text patterns 
in the text. The regular expressions described in ed (7) are avail- 
able. They must always be terminated by a <newline>, even if the 
—n option is specified. 
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i/pattern/ 


tern . Searching begins immediately after the current page 
and continues to the end of the current file, without wrap- 
around. 


i*pattern” 

i? pattern? 
Search backwards for the / th (default / =7) occurrence of 
pattern . Searching begins immediately before the current 
page and continues to the beginning of the current file, 
without wrap-around. The ~ notation is useful for Adds 100 
terminals which will not properly handle the ?. 


After searching, pg will normally display the line found at the top of 
the screen. This can be modified by appending m or b to the 


search command to leave the line found in the middle or at the bot- . 


tom of the window from now on. The suffix t can be used to restore 
the original situation. 


The user of pg can modify the environment of perusal with the fol- 
lowing commands: 


in Begin perusing the / th next file in the command line. The / 
is an unsigned number, default value is 1. 

ip Begin perusing the / th previous file in the command line. / 
is an unsigned number, default is 1. 

iw Display another window of text. If / is present, set the win- 
dow size to/. 

s filename | 


Save the input in the named file. Only the current file being 
perused is saved. The white space between the s and 
filename is optional. This command must always be ter- 
minated by a <newline>, even if the —n option is specified. 


h Help by displaying an abbreviated summary of available 
commands. 


q or Q 
Quit pg . 


!command 
Command is passed to the shell; whose name is taken from 
the SHELL environment variable. If this is not available, the 
default shell is used. This command must always be ter- 
minated by a <newline>, even if the —n option is specified. 


At any time when output is being sent to the terminal, the user can 
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hit the quit key (normally control-\) or the interrupt (break) key. This 
ar Causes pg to stop sending output, and display the prompt. The 
( j user may then enter one of the above commands in the normal 
manner. Unfortunately, some output Is lost when this is done, due 
to the fact that any characters waiting in the terminal’s output queue 

are flushed when the quit signal occurs. 


If the standard output is not a terminal, then pg acts just like cat 
(7), except that a header is printed before each file (if there is more 
than one). 


EXAMPLE 
A sample usage of pg in reading system news would be 


news | pg -p "(Page %d):" 


NOTES 
While waiting for terminal input, pg responds to BREAK , DEL , and 
“ by terminating execution. Between prompts, however, these sig- 
Nals interrupt pg ’s current task and place the user in prompt mode. 
These should be used with caution when input is being read from a 
pipe, since an interrupt is likely to terminate the other commands in 


the pipeline. 
a Users of Berkeley’s more will find that the z and f commands are 
( ) available, and that the terminal /, °, or ? may be omitted from the 
” searching commands. 
FILES 
428.sp20u 
/usr/lib/terminfo/* 
Terminal information data base 
/tmp/pg* 
Temporary file when input is from a pipe 
SEE ALSO 
crypt(1), ed(1), grep(1). 
terminfo(4) in the Sys5 UNIX Programmer Reference Manual. 
BUGS 


If terminal tabs are not set every eight positions, undesirable results 
may occur. 


When using pg as a filter with another command that changes the 
terminal 1/O options (e.g., crypt (7)), terminal settings may not be 
restored correctly. 
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NAME | 
pic — troff preprocessor for drawing simple pictures 

SYNOPSIS | 
pic [ —Tt | [ files ] 

DESCRIPTION , | 
Pic is a troff(1) preprocessor for drawing simple figures on a 
typesetter. The basic objects are box, line, arrow, circle, ellipse, 
arc and text. 
The optional argument —Tf specifies device t; currently supported 
devices are aps (Autologic APS-5), X97 (Xerox 9700), and i10 
(Imagen Imprint-10). Default is -Taps. 

SEE ALSO 


troff(1). 


PIC — A Graphics Language for Typesetting. 
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pr — print files 


SYNOPSIS 


pr [ options | | files | 


DESCRIPTION 


Page 1 


Pr prints the named files on the standard output. If file is — , or if no 
files are specified, the standard input is assumed. By default, the 
listing is separated into pages, each headed by the page number, a 
date and time, and the name of the file. 


By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the —s option is used, 
lines are not truncated and columns are separated by the separation 
character. 


If the standard output is associated with a terminal, error messages 
are withheld until pr has completed printing. 


The below options may appear singly or be combined in any order: 
+k Begin printing with page k (default is 1). 


—k Produce k -column output (default is 1). The options -e 
and -i are assumed for multi-column output. 


—a Print multi-column output across the page. 


—m Merge and print all files simultaneously, one per column 
(overrides the —k, and —a options). 


-d Double-space the output. 


—eck Expand input tabs to character positions k +1, 2* k +1, 3+ 
k +17, etc. If k is O or is omitted, default tab settings at 
every eighth position are assumed. Tab characters in the 
input are expanded into the appropriate number of spaces. 
If c (any non-digit character) is given, it is treated as the 
input tab character (default for c is the tab character). 


-ick (In output , replace white space wherever possible by insert- 
ing tabs to character positions k +1, 2* k +1, 3* k +1, etc. 
lf k is O or is omitted, default tab settings at every eighth 
position are assumed. If c (any non-digit character) is 
given, it is treated as the output tab character (default for c 
is the tab character). 


—nck Provide k -digit line numbering (default for k is 5). The 
number occupies the first kK +7 character positions of each 
column of normal output or each line of —m output. If c 
(any non-digit character) is given, it is appended to the line 
number to separate it from whatever follows (default for c is 
a tab). 
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—wk Set the width of a line to k character positions (default is 72 
for equal-width muiti-column output, no limit otherwise). — 

—Ok Offset each line by k character positions (default is 0). The 
number of character positions per line is the sum of the 
width and offset. | 

—Ik Set the length of a page to k lines (default is 66). 

—h Use the next argument as the header to be printed instead 
of the file name. 

—p Pause before beginning each page if the output is directed 
to a terminal (pr will ring the bell at the terminal and wait for 
a Carriage return). 

—f Use form-feed character for new pages (default is to use a 
sequence of line-feeds). Pause before beginning the first 
page if the standard output is associated with a terminal. 

-—r Print no diagnostic reports on failure to open files. 

—t Print neither the five-line identifying header nor the five-line 
trailer normally supplied for each page. Quit printing after 
the last line of each file without spacing to the end of the 
page. 

—SC Separate columns by the single character c instead of by 
the appropriate number of spaces (default for c is a tab). 

EXAMPLES 

Print file1 and file2 as a double-spaced, three-column listing 

headed by ‘rile list”: 
pr —3dh ‘Tile list” file1 file2 

Write file1 on file2 , expanding tabs to columns 10, 19, 28, 37,...: 
pr -e9 -t <file1 >file2 

FILES 

/dev/tty* to suspend messages 
SEE ALSO 

cat(1). 
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NAME 

printenv — print out the environment 
SYNOPSIS 

/usr/plx/printenv [ name | 
DESCRIPTION 


Printenv prints out the values of the variables in the environment. If 
a name is specified, only its value is printed. 


lf a name is specified and it is not defined in the environment, prin- 
tenv returns exit status 1, else it returns status 0. 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
sh(1), environ(5), csh(1). 
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prof — display profile data 
SYNOPSIS 
prof [-tcan] [-ox] [-g] [-z] [-h] [-s] [-m mdata] [prog] 
DESCRIPTION : 


Prof interprets a profile file produced by the monitor (3C) function. 
The symbol table in the object file prog (a.out by default) is read 
and correlated with a profile file (mon.out by default). For each 
external text symbol the percentage of time spent executing 
between the address of that symbol and the address of the next is 
printed, together with the number of times that function was called 

and the average number of milliseconds per call. | 


The mutually exclusive options t, c, a, and n determine the type of 
sorting of the output lines: 


—t sort by decreasing percentage of total time (default). 
—C Sort by decreasing number of calls. 

—a Sort by increasing symbol address. 

-—n sort lexically by symbol name. 


The mutually exclusive options o and x specify the printing of the 
address of each symbol monitored: 


—O Print each symbol address (in octal) along with the symbol 
name. 
—X Print each symbol address (in hexadecimal) along with the 


symbol name. 
The following options may be used in any combination: 
-g Include non-global symbols (static functions). 


-z Include all symbols in the profile range (see monitor (3C)), 
even if associated with zero number of calls and zero time. 


—h Suppress the heading normally printed on the report. (This 
is useful if the report is to be processed further.) 


—-S Print a summary of several of the monitoring parameters 
| and statistics on the standard error output. 


—m mdata 
Use file mdata instead of mon.out as the input profile file. 


A program creates a profile file if it has been loaded with the -p 
option of cc (7). This option to the cc command arranges for calls 
to monitor (3C) at the beginning and end of execution. It is the call 
to monitor at the end of execution that causes a profile file to be 
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written. The number of calls to a function is tallied if the —p option 
was used when the file containing the function was compiled. 


\ 
\ 


i “S 


eee 


The name of the file created by a profiled program is controlled by 
the environment variable PROFDIR. If PROFDIR does not exist, 
“mon.out” is produced in the directory current when the program 
terminates. If PROFDIR = string, “string, pid.progname’” is produced, 
where progname consists of argv[0] with any path prefix removed, 
and pid is the program's process id. If PROFDIR = nothing, no pro- 
filing output is produced. 


A single function may be split into subfunctions for profiling by 
means of the MARK macro (see prof (5)). 


FILES 
mon.out for profile 
a.out for namelist | 
SEE ALSO 


cc(1). 
exit(2), profil(2), monitor(3C), prof(5) in the Sys5 UNIX Programmer 
Reference Manual. 


WARNING 
The times reported in successive identical runs may show variances ~— 
of 20% or more, because of varying cache-hit ratios due to sharing 
of the cache with other processes. Even if a program seems to be 
the only one using the machine, hidden background or asynchro- 
nous processes may blur the data. In rare cases, the clock ticks ini- 
tiating recording of the program counter may ‘beat’ with loops in a 
program, grossly distorting measurements. 


Call counts are always recorded precisely, however. 


BUGS | 
Only programs that call exit (2) or return from main will cause a pro- 
file file to be produced, unless a final call to monitor is explicitly 
coded. 


The use of the —p option cc (7) to invoke profiling imposes a limit of 
600 functions that may have call counters established during pro- 
gram execution. For more counters you must call monitor (3C) 
directly. If this limit is exceeded, other data will be overwritten and 
the mon.out file will be corrupted. The number of call counters 
used will be reported automatically by the prof command whenever 
the number exceeds 5/6 of the maximum. 
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prs — print an SCCS file 
SYNOPSIS 
prs [-—d[dataspec]] [-r[SID]] [-e] [-l] [-c[date-time]] [—-a] files 
DESCRIPTION 
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Prs prints, on the standard output, parts or all of an SCCS file (see 
sccsfile (4)) in a user-supplied format. If a directory is named, prs 
behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path 
name does not begin with s.), and unreadable files are silently 
ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file or 
directory to be processed; non-SCCS files and unreadable files are 
silently ignored. 


Arguments to prs , which may appear in any order, consist of 
keyletter arguments, and file names. 


All the described keyletter arguments apply independently to each 
named file: 


-—d[dataspec] Used to specify the output data specification. 
The dataspec is a string consisting of SCCS 
file data keywords (see DATA KEYWORDS )} 
interspersed with optional user supplied text. 


—r[S/D] Used to specify the S CCS I/D entification 
(SID) string of a delta for which information is 
desired. If no SID is specified, the SID of the 
most recently created delta is assumed. -e 
and -I keyletters. The format for the date is: 
mmddyy [hh:mm:ss]. 


—e Requests information for all deltas created 
earlier than and including the delta desig- 
nated via the -r keyletter or the date given by 
the -—c option. 


—| Requests information for all deltas created 
later than and including the delta designated 
via the -r keyletter or the date given by the 
—C option. 

[—c[cutoff]] Cutoff date-time, in the form: 


YY[MM[DD[HH[MM[SS]]]]] 


May 27, 1985 


PRS(1) 


UNIX Sys5 PRS(1) 


-c[date-time] Units omitted from the date-time default to 
their maximum possible values; that is, 
-c7502 is equivalent to -c750228235959. 
Any number of non-numeric characters may 
separate the various 2-digit pieces of the cut- 
off date in the form: "-—c77/2/2 9:22:25". 


-a Requests printing of information for both 
removed, i.e., delta type = R , (see rmdel 
(1)) and existing, i.e., delta type = D, deltas. 
If the —a keyletter is not specified, information 
for existing deltas only is provided. 


DATA KEYWORDS 


Data keywords specify which parts of an SCCS file are to be 
retrieved and output. All parts of an SCCS file (see sccsfile (4)) 
have an associated data keyword. There is no limit on the number 
of times a data keyword may appear in a dataspec . 


The information printed by prs consists of: (1) the user-supplied 
text; and (2) appropriate values (extracted from the SCCS file) sub- 
stituted for the recognized data keywords in the order of appear- 
ance in the dataspec. The format of a data keyword value is either 
Simple (S), in which keyword substitution is direct, or Multi-line (M), 
in which keyword substitution is followed by a carriage return. 


User-supplied text is any text other than recognized data keywords. 

A tab is specified by \t and carriage return/new-line is specified by 

\n. The default data keywords are: 
“Dtat:DL:\nMRs:\n:MR:COMMENTS:\n:C:" 


TABLE 1. SCCS Files Data Keywords 


eee 


KeywordData Item File Section Value Format 


:Dt: 


Deita information Delta Table See below* 
Delta line statistics : :Li:/:Ld:/:Lu: 
Lines inserted by Delta i nnnnn 
Lines deleted by Delta " nnnnn 
Lines unchanged by Delta 7 nnnnn 
Delta type : DorR 
SCCS ID string (SID) " *R:.:k:.:B:.:S: 
Release number . nnnn 
Level number ed nnann 
Branch number , e nnnn 
Sequence number nnnn 
Date Delta created | :Dy:/:Dm:/:Dd: 
Year Delta created : . nn 
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; :Dm: Month Delta created 7 nn 
C. :Dd: Day Delta created : nn 
7 | :T: Time Delta created : PTh:::Tm:::Ts: 
:Th: Hour Delta created ‘ nn 
‘Tm: Minutes Delta created nn 
‘Ts: Seconds Delta created | i nn 
:P: Programmer who created Delta ‘ logname 
:DS: Delta sequence number " nnnn 
:DP: Predecessor Delta seq-no. nnnn 
:DI: Seq-no. of deltas incl., excl., ignored :Dn:':Dx:/:Dg: 
:Dn: Deltas included (seq #) :DS: :DS:... 
:Dx: Deltas excluded (seq #) :DS: :DS:... 
:Dg: Deltas ignored (seq #) ‘DS: -DS:..:: 
:-MR: MR numbers for delta text 
:C: Comments for deita text 
:UN: User names User Names text 
“FL: Flag list Flags text 
:Y: Module type flag e text 
:MF: MR validation flag yes or no 
:MP: MR validation pgm name text 
:KF: Keyword error/warning flag yes or no 
:KV: Keyword validation string text 
_  iBF: Branch flag : yes orno 
a iJ: Joint edit flag yes or no 
( ' iLK: Locked releases sRe ee. 
—- :Q: User defined keyword text 
:-M: Module name text 
:-FB: Floor boundary :‘R: 
:CB: Ceiling boundary :R: 
:Ds: Default SID I: 
:ND: Null delta flag yes orno 
‘FD: File descriptive text Comments text 
:BD: Body Body text 
:<GB: Gotten body 7 text 
:W: A form of what(1) string N'A :Z2.M\tih: 
-A: A form of what(1) string JA 12:3¥2 3M: ::Z: 
:Z: what(1) string delimiter N/A @(#) 
:F: SCCS file name N/A text 
:PN: SCCS file path name N/A text 
*:Dt: = :DT: :h: :D: :T: :P: :DS: :DP: 
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EXAMPLES | 
prs —d"Users and/or user IDs for :F: are:\n:UN:" s.file 


may produce on the standard output: 
Users and/or user IDs for s.file are: 
xyz 
131 
abc 


prs —d"Newest delta for pgm :M:: :l: Created :D: By :P:" -r 
S.file 


may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12.1 By cas 
As a special case: 

prs s.file 
may produce on the standard output: 


D 1.1 77/12/1 00:00:00 cas 1 0O0000/00000/00000 
MRs: 

bI78-12345 

bI79-54321 

COMMENTS: | 

this is the comment line for s.file initial delta tous! 


for each delta table entry of the “D” type. The only keyletter argu- 
ment allowed to be used with the special case is the —a keyletter. 


FILES 


SEE ALSO | | 
admin(1), delta(1), get(1), help(1). | 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
Use help (1) for explanations. 
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ps — report process status 

SYNOPSIS 
ps [ options |] 


DESCRIPTION 
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Ps prints certain information about active processes. Without 
options , information ts printed about processes associated with the 
current terminal. The output consists of a short listing containing 
only the process ID, terminal identifier, cumulative execution time. 
and the command name. Otherwise. the information that is 
displayed is controlled by the selection of options . 


Options using lists as arguments can have the list specified in one 
of two forms: a iist of identifiers separated from one another by a 
comma, or a list of identifiers enclosed in double quotes and 
separated from one another by a comma andor one or more 
spaces. 


The options are: 


—e Print information about all processes. 

—d Print information about all processes, except process 
group leaders. 

—a Print information about all processes, except process 
group leaders and processes not associated with a ter- 
minal. 

—f Generate a full listing. (See below for meaning of 


columns in a full listing). 

| Generate a /ong listing. See below. 

-c corefile Use the file corefile in place of ‘dev’mem . 

-S swapdev Use the file swapdev in place of ‘dev’swap . This is 
useful when examining a corefile ; a swapdev of 
/dev/null will cause the user block to be zeroed out. 

—n namelist The argument will be taken as the name of an alter- 
nate system nameliist file in place of /unix. 

-ttermlist Restrict listing to data about the processes associated 
with the terminals given in termiist . Terminal identifiers 
may be specified in one of two forms: the device's file 
name (e.g., ttyO4) or if the device's file name starts 
with tty, just the digit identifier (e.g., 04). 

-p prociist Restrict listing to data about processes whose process 
ID numbers are given in prociist . 

—u uidlist Restrict listing to data about processes whose user ID 
numbers or login names are given in uidiist . In the 
listing, the numerical user ID will be printed unless the 
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—f option is used, in which case the login name will be 
printed. 

~ggrplist Restrict listing to data about processes whose process \-” 
group leaders are given in grpliist . 


The column headings and the meaning of the columns in a ps list- 
ing are given below; the letters f and I indicate the option (full or 
long ) that causes the corresponding heading to appear; all means 
that the heading always appears. Note that these two options 
determine only what information is provided for a process; they do 
not determine which processes will be listed. 


F (1) Flags (octal and additive) associated with the pro- 
cess: 
6) swapped; 
1 in core; 
2 system process; 
4 locked-in core (e.g., for physical IO); 


10 being swapped; 
20 being traced by another process; 
40 another tracing flag; 


S (I) The state of the process: 
0 non-existent; = 
S sleeping: a 
W waiting; 4 
R running; 
| intermediate; 
Z terminated; 
iE stopped; 
| X growing. 
UID (f,!) § The user ID number of the process owner; the 
login name is printed under the —f option. 
PID (all) |The process ID of the process; it is possible to kill 
a process if you know this datum. 
PPID (f,1) The process ID of the parent process. 
Cc (f,!) Processor utilization for scheduling. 
PRI (I) The priority of the process; higher numbers mean 
lower priority. | 
NI (I) Nice value; used in priority computation. 
ADDR (1) The memory address of the process if resident; 
otherwise, the disk address. 
SZ (1) The size in blocks of the core image of the pro- 
cess. 
WCHAN (i) The event for which the process is waiting or « ~ 
sleeping; if blank, the process is running. ‘S ’ 
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CC STIME (f) Starting time of the process. 
( TTY (all) § The controlling terminal for the process. 
TIME (all) ©The cumulative execution time for the process. 
CMD (all) ©The command name; the full command name and 


its arguments are printed under the —-f option. 


A process that has exited and has a parent, but has not yet been 
waited for by the parent, is marked <defunct> . 


Under the -f option, ps tries to determine the command name and 
arguments given when the process was created by examining 
memory or the swap area. Failing this, the command name, as it 
would appear without the -f option, is printed in square brackets. 


FILES 
/ UNIX system namelist 
‘dev:'mem memory 
idev swap the default swap device 
‘etc: passwd supplies UID information 
ietc.ps_data_ internal data structure 


‘dev searched to find terminal (“tty”) names 
SEE ALSO 
(_ acctcom(1), kill(1), nice(1). 
L_ BUGS 


Things can change while ps is running; the picture it gives is only a 
close approximation to reality. Some data printed for defunct 
processes are irrelevant. 
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ptx — permuted index 


SYNOPSIS 


ptx [ options ] [ input [ output | | 


DESCRIPTION 
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Ptx generates the file output that can be processed with a text for- 
matter to produce a permuted index of file input (standard input and 
output default). It has three phases: the first does the permutation, 


generating one line for each keyword in an input line. The keyword 


is rotated to the front. The permuted file is then sorted. Finally, the 
sorted lines are rotated so the keyword comes at the middle of each 
line. Ptx output is in the form: 


.xx tail” "before keyword" "keyword and after” “head” 


where .xx is assumed to be an nroff or troff (1) macro provided by 
the user, or provided by the mptx (5) macro package. The before 
keyword and keyword and after fields incorporate as much of the 
line as will fit around the keyword when it is printed. Jal and head , 
at least one of which is always the empty string, are wrapped- 
around pieces small enough to fit in the unused space at the oppo- 
site end of the line. 


The following options can be applied: 


—f Fold upper and lower case letters for sorting. 
-t Prepare the output for the phototypesetter. 
—-wn Use the next argument, 7 , as the length of the output 


line. The default line length is 72 characters for nroff 
and 100 for troff . 


-gn Use the next argument, 7 , as the number of characters 
that ptx will reserve in its calculations for each gap 
among the four parts of the line as finally printed. The 
default gap is 3. 


—O only Use as keywords only the words given in the only file. 


-i ignore Do not use as keywords any words given in the ignore 
file. If the -i and -o options are missing, use 
/usr/lib/eign as the ignore file. 


-b break Use the characters in the break file to separate words. 
Tab, new-line, and space characters are always used 
as break characters. 
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-r Take any leading non-blank characters of each input 
line to be a reference identifier (as to a page or 
chapter), separate from the text of the line. Attach that 
identifier as a 5th field on each output line. 


The index for this manual was generated using ptx . 


FILES 
/bin/sort 
/usrilibreign 
/usrlib/tmac. tmac.ptx 


SEE ALSO 
nroff(1), troff(1). 
mm(5), mptx(5) in the Sys5 UNIX Programmer Reference Manual. 


BUGS 
Line length counts do not account for overstriking or proportional 
spacing. 
Lines that contain tildes (") are botched, because ptx uses that 
character internally. 
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NAME —_ 
pwd — working directory name eae 
SYNOPSIS | 
pwd 
DESCRIPTION 
Pwd prints the path name of the working (current) directory. 
SEE ALSO 
cd(1). 


DIAGNOSTICS 
“Cannot open ..” and “Read error in ..” indicate possible file system 
trouble and should be referred to a UNIX system programming coun- 
selor. 
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( -NAME 
E. 2 ratfor — rational Fortran dialect 


SYNOPSIS 
ratfor [ options | [ files ] 


DESCRIPTION 3 
Ratfor converts a rational dialect of Fortran into ordinary irrational 
Fortran. Ratfor provides control flow constructs essentially identical 
to those in C: 


statement grouping: 
{ statement; statement; statement | 


decision-making: 
if (condition) statement [ else statement | 
switch (integer value) { 
case integer: statement 


[ default: | statement 


loops: 
Pe while (condition) statement 
( } for (expression; condition; expression) statement 
do limits statement 
repeat statement [ until (condition) | 
break 
next 


and some syntactic sugar to make programs easier to read and 
write: 
free form input: 
multiple statements line; automatic continuation 


comments: 
# this is a comment. 


translation of relationals: 
>, >=, etc., become .GT. , .GE. , etc. 


return expression to caller from function: 
return (expression) 


define: 
define name replacement 


‘aee include: 
pd inciude file 
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The option —h causes quoted strings to be turned into 27H con- “ — 
structs. The -C option copies comments to the output and attempts < 
to format it neatly. Normally, continuation lines are marked with a & 
in column 1; the option -6x makes the continuation character x and 
places it in column 6. 


Ratfor is best used with f77 (7). 
SEE ALSO 
efl(1), £77(1). 


B. W. Kernighan and P. J. Plauger, Software Tools , Addison- 
Wesley, 1976. 
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NAME 


regcmp — regular expression compile 


SYNOPSIS 


regcmp [ — | files 


DESCRIPTION 


Regcmp , in most cases, precludes the need for calling regcomp 
(3X) from C programs. This saves on both execution time and pro- 
gram size. The command regcmp compiles the regular expres- 
sions in file and places the output in file.i. If the — option is used, 
the output will be placed in file.c. The format of entries in file is a 
name (C variable) followed by one or more blanks followed by a reg- 
ular expression enclosed in double quotes. The output of regcmp is 
C source code. Compiled regular expressions are represented as 
extern char vectors. File.i files may thus be included into C pro- 
grams, or file.c files may be compiled and later loaded. In the C 
program which uses the regcomp output, regex ( abc , fine ) will 
apply the regular expression named abc to line . Diagnostics are 
self-explanatory. 


EXAMPLES 


name ‘([A-Za—z][A-Za—z0-9_]*)$0" 


“(l 
telno — “\({0,1}([2-9][01][1-9])$0\){0, 1} +" 
"([2-9][0-9]{2!)$1[ —]{0, 1}" 
“((O-9],4)$2" 


In the C program that uses the regcmp output, 
regex(telno, line, area, exch, rest) 


will apply the regular expression named felno to /ine. 


SEE ALSO 
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regcmp(3X) in the Sys5 UNIX Programmer Reference Manual. 
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rm, rmdir — remove files or directories 


SYNOPSIS 


rm [ —fri ] file ... 
rmdir dir ... 


DESCRIPTION 


Rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 


If a file has no write permission and the standard input is a terminal, 
its permissions are printed and a line is read from the standard 
input. If that line begins with y the file is deleted, otherwise the file 
remains. No questions are asked when the —f option is given or if 
the standard input is not a terminal. 


lf a designated file is a directory, an error comment is printed unless 
the optional argument —r has been used. In that case, rm recur- 
sively deletes the entire contents of the specified directory, and the 
directory itself. 


If the -i (interactive) option is in effect, rm asks whether to delete 
each file, and, under -r , whether to examine each directory. 


Rmdir removes entries for the named directories, which must be 
empty. 


SEE ALSO 


unlink(2) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 
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Generally self-explanatory. It is forbidden to remove the file .. 
merely to avoid the antisocial consequences of inadvertently doing 
something like: 


rm —-f .* 
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_ NAME 
3 rmdel — remove a delta from an SCCS file 
SYNOPSIS 


rmdel —-rSID files 


DESCRIPTION . 


Rmdel removes the delta specified by the S/D from each named 


~ SCCS file. The delta to be removed must be the newest (most 


recent) delta in its branch in the delta chain of each named SCCS 
file. In addition, the specified must not be that of a version being 
edited for the purpose of making a delta (i. e., if a p-file (see get 
(1)) exists for the named SCCS file, the specified must not appear 
in any entry of the p-file). | 


If a directory is named, rmde! behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files 
(last Component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of —- is given, the 
standard input is read; each line of the standard input is taken to be 
the name of an SCCS file to be processed; non-SCCS files and 
unreadable files are silently ignored. 


The exact permissions necessary to remove a delta are docu- 
mented in the Source Code Control System User Guide . Simply 
stated, they are either (1) if you make a delta you can remove it; or 
(2) if you own the file and directory you can remove a delta. 


FILES 
x.file (see delta (1)) 
z.file (see delta (1)) 
SEE ALSO 
delta(1), get(1), help(1), prs(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 
DIAGNOSTICS 
Use help (1) for explanations. 
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sact — print current SCCS file editing activity 


SYNOPSIS 
sact files 


DESCRIPTION 


Sact informs the user of any impending deltas to a named SCCS 
file. This situation occurs when get (7) with the -e option has been 
previously executed without a subsequent execution of delta (7). If 
a directory is named on the command line, sact behaves as though 
each file in the directory were specified as a named file, except that 
non-SCCs files and unreadable files are silently ignored. If a name 
of — is given, the standard input is read with each line being taken 
as the name of an SCCS file to be processed. 


The output for each named file consists of five fields separated by 


Spaces. 
Field 1 


Field 2 
Field 3 


Field 4 
Field 5 
SEE ALSO 


specifies the SID of a delta that currently exists in 
the SCCS file to which changes will be made to 
make the new delta. 


specifies the SID for the new delta to be created. 


contains the logname of the user who will make 
the delta (i.e., executed a get for editing). 


contains the date that get -e was executed. 


contains the time that get —-e was executed. 


delta(1), get(1), unget(1). 


DIAGNOSTICS 


Use help (1) for explanations. 
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NAME 


Sag — system activity graph 


SYNOPSIS 


Sag [ options | 


DESCRIPTION ; 
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Sag graphically displays the system activity data stored in a binary 
data file by a previous sar (7) run. Any of the sar data items may 
be plotted singly. or in combination; as cross plots, or versus time. 
Simple arithmetic combinations of data may be specified. Sag 
invokes sar and finds the desired data by string-matching the data 
column header (run sar to see what is available). These options are 
passed through to sar. 


-s time Select data later than time in the form hh[{:mm]. Default 
is 08:00. 


-—e time Select data up to time . Default is 18:00. 


—i SEC Select data at intervals as close as possible to sec 
seconds. 


—f file Use file as the data source for sar. Default is the current 
daily data file /usr’adm/sa/sadd. 


Other options: 


-T term Produce output suitable for terminal term. See tplot(1G) 
for known terminals. If term is vpr , output is processed 
by vpr —p and queued to a Versatec printer. Default for 
ferm is $STERM. 


—-X Spec xX axis Specification with spec in the form: 
"name[op name}...[lo hi] 


-y spec y axis specification with spec in the same form as above. 


Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, e.g., 
r+w/s[dsk-1], or an integer value. Op is + — * or / surrounded 
by blanks. Up to five names may be specified. Parentheses are 
not recognized. Contrary to custom, + and -— _ have pre- 
cedence over * and / . Evaluation is left to right. Thus 
A/A + B * 100 iS evaluated (A/(A+B))*100, and 
A+ B:;C+ D is (A+B)(C+D). Lo and hi are optional 
numeric scale limits. If unspecified, they are deduced from the data. 
A single spec is permitted for the x axis. If unspecified, time is 
used. Up to 5 spec's separated by ; may be given for -y . Enclose 
the -x and —-y arguments in "" if blanks or \<CR> are included. 
The -y default ts: 
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-y “%usr 0 100; %usr + %sys 0 100; %usr + %Sys + 


*wio 0 100" 


EXAMPLES 
To see today’s CPU utilization: 
sag 


To see activity over 15 minutes of all disk drives: 
TS= date +%H:%M> 
sar —o tempfile 60 15 
TE=*‘date ~°oH:% 


sag -f tempfile -s $TS -e $TE -y "r+ws[dsk]" 


FILES 
‘usradmsasadd daily data file for day dd. 


SEE ALSO . 
sar(1), tolot(1G). 
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NAME 


UNIX Sys5 SAR(1) 


sar — system activity reporter 


SYNOPSIS 


sar [—ubdycwaqvmA] [-o file] t [ n ] 
sar [-ubdycwaqvmA] [-s time] [-e time] [-i sec] [-f file] 


DESCRIPTION 
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Sar, in the first instance, samples cumulative activity counters in the 
operating system at n intervals of tf seconds. If the -—o option is 
specified, it saves the samples in file in binary format. The default 
value of n is 1. In the second instance, with no sampling interval 
specified, sar extracts data from a previously recorded file, either 
the one specified by -f option or, by default. the standard system 
activity daily data file /usr’adm.'sa‘sadd for the current day dd. The 
starting and ending times of the report can be bounded via the -s 
and —e time arguments of the form Ah [: mm [: ss ]]. The -i option 
selects records at sec second intervals. Otherwise, all intervals 
found in the data file are reported. 


In either case, subsets of data to be printed are specified by option: 


-—u Report CPU utilization (the default): 

%uUSI, %SYS, %wid, %idle — portion of time running in user 
mode, running in system mode, idle with some process waiting 
for block lO, and otherwise idle. 

-b Report buffer activity: 
bread/s, bwritis — transfers per second of data between sys- 
tem buffers and disk or other block devices; 
lread’s, lwrit/s — accesses of system buffers; 

%rcache, %wcache — cache hit ratios, e. g., 1 — bread lread; 
preadis, pwrit/s — transfers via raw (physical) device mechan- 
ism. 

-d Report activity for each block device, e. g., disk or tape drive: 
%busy, avque — portion of time device was busy servicing a 
transfer request, average number of requests outstanding dur- 
ing that time; | 
r+w/s, biks‘s — number of data transfers from or to device, 
number of bytes transferred in 1024-byte units; 
avwait, avserv — average time in ms. that transfer requests 
wait idly on queue, and average time to be serviced (which for 
disks includes seek, rotational latency and data transfer 
times). 

~y Report TTY device activity: 
rawch/s, canch/s, outch/s — input character rate, input charac- 
ter rate processed by canon, output character rate; 
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revins, xmtin/s, mdmin/s — receive, transmit and modem inter- “ ~ 
rupt rates. | 
-c Report system calls: 
scall/s — system calls of all types; 
sread's, swrit’s, fork.s, exec’s — specific system calls; 
rchar’s, wchars — characters transferred by read and write 
system calls. 
-w Report system swapping and switching activity: 
swpins, swpots, bswins. bswot s — number of transfers and 
number of 1024-byte units transferred for swapins (including 
initial loading of some programs) and swapouts; 
pswch.s -- process switches. 
-a Report use of file access system routines: 
iget's, names, dirbik:s. 
-q Report average queue length while occupied, and % of time 
occupied: 
runq-sz, Yorunocc — run queue of processes in memory and 
runnable; 
Swpq-SzZ, YoSwpocc — swap queue of processes swapped out 
but ready to run. 
-v Report status of text, process, inode and file tables: 

— text-sz, proc-sz, inod-sz, file-sz — entries’size for each table, 
evaluated once at sampling point; ee 
text-ov, proc-ov, inod-ov, file-ov — overflows Occuring between 
sampling points. 

—m Report message and speaoniors activities: 
msg/s, sema/s — primitives per second. 
-A Report all data. Equivalent to -udqbwcayvm . 
EXAMPLES 
To see today’s CPU activity so far: 
Sar 
To watch CPU activity evolve for 10 minutes and save data: 
sar —o temp 60 10 
To later review disk and tape activity from that atid: 
sar —d -f temp 


MN 


Se 


FILES | 
‘usr/admisa/sadd daily data file, where dd are digits representing 
the day of the month. 
SEE ALSO 

sag(1G). 

sar(1M) in the Sys5 UNIX Administrator Reference Manual. 
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~ NAME 
j scc — C compiler for stand-alone programs 


SYNOPSIS 
sec [ +[ lib] ] [ option ] ... [ file ] ... 


DESCRIPTION | 
Scc prepares the named files for stand-alone execution. The 
option and file arguments may be anything that can legally be used 
with the cc command; it should be noted, though, that the —p (profil- 
ing) option, as well as any object module that contains system calls, 
will cause the executable not to run. 


Scc defines the compiler constant, STANDALONE, so that sections 
of C programs may be compiled conditionally when the executable 
will be run stand-alone. 


If no +/ib argument is specified, +A is assumed. If the + argu- 
ment is specified alone, no configuration library is loaded unless the 
user Supplies his own. 


FILES 
flib/crt2.0 execution start-off 
fusr/lib/lib2.a stand-alone library 
Cc fusr/lib/lib2A.a +A configuration library 


’ SEE ALSO 


cc(1), Id(1). 
a.out(4) in the UNIX System Programmer Reference Manual. 
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fr - NAME 
( sccsdiff — compare two versions of an SCCS file 


SYNOPSIS 
sccsdiff -r SID1 -r SID2 [-p] [-—sn] files 

DESCRIPTION | 
Sccsdiff compares two versions of an SCCS file and generates the 
differences between the two versions. Any number of SCCS files 
may be specified, but arguments apply to all files. 


—rSiD? SID1 and SID2 specify the deltas of an SCCS 
file that are to be compared. Versions are 
passed to bdiff (1) in the order given. 


—p pipe output for each file through pr (7). 


-Ssn n is the file segment size that bdiff will pass to 
diff (1). This is useful when diff fails due to a 
high system load. 


FILES 


SEE ALSO 
( bdiff(1), get(1), help(1), pr(1). 


Source Code Control! System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
“file: No differences’ lf the two versions are the same. 
Use help (1) for explanations. 
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NAME ets 
script — make typescript of terminal session _ | 


SYNOPSIS 
/usr/plx‘script [ -n ] [--s ] [ -a ] [-q ][ -S shell ] [ file ] 


DESCRIPTION 
Script makes a typescript of everything printed on your terminal. 
The typescript is saved in a file, and can be sent to the line printer 
later with /pr. If a file name is given, the typescript is saved there. If 
not, the typescript is saved in the file typescript. 


To exit script, type control D. This sends an end of file to all 
processes you have started up, and causes script to exit. For this 
reason, control D behaves as though you had typed an infinite 
number of control D's. 


This program is useful when using a CRT and a hard-copy record of 
the dialog is desired, as for a student handing in a program that was 
developed on a CRT when hard-copy terminals are in short supply. 


The options control what shell is used. —n asks for the new sheil, 

-—§ asks for the standard shell. -—S lets you specify any shell you 
want. The default depends on the system: bin.sh is used where 
possible, otherwise ‘bin/sh. If the requested shell is not available, 
script uses any shell it can find. ee 


The -q flag asks for “quiet mode’, where the “script started” and 
“script done” messages are turned off. The —a flag causes script to 
append to the typescript file instead of creating a new file. 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


BUGS 
Since UNIX has no way to write an end-of-file down a pipe without 
closing the pipe, there is no way to simulate a single control D 
without ending script. 


The new shell has its standard input coming from a pipe rather than 
a tty, so stty will not work, and neither will ttyname. 


When the user interrupts a printing process, script attempts to flush 
the output backed up in the pipe for better response. Usually the 
next prompt also gets flushed. 
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~~ NAME 
sdiff — side-by-side difference program 
SYNOPSIS 
sdiff [ options ... ] file1 file2 
DESCRIPTION 
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Sdiff uses the output of diff (1) to produce a side-by-side listing of 
two files indicating those lines that are different. Each line of the 
two files is printed with a blank gutter between them if the lines are 
identical, a < in the gutter if the line only exists in file7 , a > in the 
gutter if the line only exists in file2 , and a | for lines that are dif- 


ferent. 

For example: 
Xx y 
a a 
b = 
C ae 
d d 

> C 


The following options exist: 


—-W if 


—| 
-S 
-O oulpul 


Use the next argument, n , as the width of the output 
line. The default line length is 130 characters. 


Only print the left side of any lines that are identical. 
Do not print identical lines. 


Use the next argument, output , as the name of a third 
file that is created as a user-controlled merging of file? 
and file2 . |dentical lines of file? and file2 are copied to 
output . Sets of differences, as produced by alff (7), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of the 
following user-typed commands: 


I append the left column to the output 


file 

r append the right column to the output 
file 

Ss turn on silent mode; do not print identi- 
cal lines 

Vv turn off silent mode 
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e | call the editor with the left column _ 
er call the editor with the right column ae 


eb call the editor with the concatenation 
of left and right 


call the editor with a zero length file 


q exit from the program 


On exit from the editor, the resulting file is concatenated 
on the end of the output file. 


SEE ALSO 
diff(1), ed(1). 
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NAME 


UNIX Sys5 SED(1) 


sed — stream editor 


SYNOPSIS 


sed [ -n ] [ -e script | [ -f sfile ] [ files ] 


DESCRIPTION | 
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Sed copies the named files (standard input default) to the standard 
output, edited according to a script of commands. The -f option 
causes the script to be taken from file sfile ; these options accumu- 
late. If there is just one -e option and no -f options, the flag -e 
may be omitted. The —n option suppresses the default output. A 
script consists of editing commands, one per line, of the following 
form: 


{ address [ , address | | function [ arguments ] 


In normal operation, sed cyclically copies a line of input into a pat- 
fern space (unless there is something left after a D command), 
applies in sequence all commands whose addresses select that 
pattern space, and at the end of the script copies the pattern space 
to the standard output (except under —n ) and deletes the pattern 
space. 


Some of the commands use a hold space to save all or part of the 
pattern space for subsequent retrieval. 


An address is either a decimal number that counts input lines cumu- 
latively across files, a $ that addresses the last line of input, or a 
context address, i.e., a ‘regular expression’ in the style of ed (7) 
modified thus: 


In a context address, the construction \?regular expres- 
sion?, where ? is any character, is identical to /reg- 
ular expression’. Note that in the context address 
\xabc\xdefx , the second x stands for itself, so that 
the regular expression is abcxdef . 

The escape sequence \n matches a new-line embedded in 
the pattern space. 

A period . matches any character except the terminal new- 
line of the pattern space. 

A command line with no addresses selects every pattern 
space. 

A command line with one address selects each pattern 
space that matches the address. 

A command line with two addresses selects the inclusive 
range from the first pattern space that matches the 
first address through the next pattern space that 
matches the second. (lf the second address is a 
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number less than or equal to the line number first <> 


selected, only one line is selected.) Thereafter the . 


process is repeated, looking again for the first 
address. 


Editing commands can be applied only to non-selected pattern 
spaces by use of the negation function ! (below). 


In the following list of functions the maximum number of permissible 
addresses for each function is indicated in parentheses. 


The text argument consists of one or more lines, all but the last of 
which end with \ to hide the new-line. Backslashes in text are 
treated like backslashes in the replacement string of an s command, 
and may be used to protect initial blanks and tabs against the strip- 
ping that is done on every script line. The rfile or wfile argument 
must terminate the command line and must be preceded by exactly 
one blank. Each wfile is created before processing begins. There 
can be at most 10 distinct wfile arguments. 


(1) a\ 


text Append. Place text on the output before reading the 
next input line. 
(2)b " label" 


oa 


Branch to the : command bearing the label . If label is _ 


empty, branch to the end of the script. 


(2) c\ 

text Change. Delete the pattern space. With 0 or 1 address 
or at the end of a 2-address range, place text on the out- 
put. Start the next cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through 
the first new-line. Start the next cycle. 

(2)g Replace the contents of the pattern space by the con- 
tents of the hold space. 

(2)G Append the contents of the hold space to the pattern 
space. 

(2)h Replace the contents of the hold space by the contents 
of the pattern space. 

(2) H Append the contents of the pattern space to the hold 
space. 

(1) iN | 

text Insert. Place text on the standard output. 

(2) _ List the pattern space on the standard output in an 
unambiguous form. Non-printing characters are spelled 
in two-digit ASCII and long lines are folded. 
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(2)n Copy the pattern space to the standard output. Replace 
the pattern space with the next line of input. 

(2)N Append the next line of input to the pattern space with 
an embedded new-line. (The current line number 
changes.) 

(2)p Print. Copy the pattern space to the standard output. 

P Copy the initial segment of the pattern space through the 
first new-line to the standard output. 

(1)q Quit. Branch to the end of the script. Do not start a new 
cycle. 

(2)r rfile Read the contents of rfile . Place them on the output 
before reading the next input line. 

(2) S/ “regular expression" ' replacement : flags 
Substitute the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be used instead of / . For a fuller description see ed 
(1). Flags is zero or more of: 


n n= 1-512. Substitute for just the n th 
occurrence of the regular expression. 
g Global. Substitute for all nonoverlapping 


instances of the regular expression 
rather than just the first one. 

fe) Print the pattern space if a replacement 
was made. 

w wiile Write. Append the pattern space to 
wile if a replacement was made. 

(2)t /abe/ Test. Branch to the : command bearing the /abe/ if any 
substitutions have been made since the most recent 
reading of an input line or execution of at . If /abel/ is 
empty, branch to the end of the script. 

(2) w while Write. Append the pattern space to wile . 

(2) x Exchange the contents of the pattern and hold spaces. 

(2) y/string1string2 
Transform. Replace all occurrences of characters in 
String? with the corresponding character in string2 . The 
lengths of string? and string2 must be equal. 

(2)! function 
Don't. Apply the function (or group, if function is { ) only 
to lines not selected by the address(es). 

(0): /abel This command does nothing; it bears a /abe/ for b and t 
commands to branch to. 

(1) = Place the current line number on the standard output as 
a line. | 
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SEE ALSO 


awk(1), ed 


May 27, 1985 


UNIX Sys5 SED(1) 


Execute the following commands through a matching a i 
only when the pattern space is selected. Ke dl 
An empty command is ignored. 

lf a # appears as the first character on the first line of a 
script file, then that entire line is treated as a comment, 
with one exception. If the character after the # is ann’, 
then the default output will be suppressed. The rest of 
the line after # n is also ignored. A script file must con- 
tain at least one non-comment line. 


(1), grep(1). 


Page 4 


SH(1) 


_ NAME 


oe 


( } 


j 


) 


UNIX Sys5 SH(1) 


sh, rsh — shell, the standard/restricted command programming 


language 
SYNOPSIS 
sh [ —acefhiknrstuvx | [ args ] 
rsh [ -acefhiknrstuvx | [ args ] 
DESCRIPTION 


Sh is a command programming language that executes commands 
read from a terminal or a file. Ash is a restricted version of the 
standard command interpreter sh ; it is used to set up login names 
and execution environments whose capabilities are more controlled 
than those of the standard shell. See /nvocation below for the 
meaning of arguments to the shell. 


Definitions 


A blank is a tab or a space. A name is a sequence of letters, digits, 
or underscores beginning with a letter or underscore. A parameter 


is a name, a digit, or any of the characters +, @, #,?,-,$, and 
1, | 


Commands 
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A simple-command is a sequence of non-blank words separated by 
blanks . The first word specifies the name of the command to be 
executed. Except as specified below, the remaining words are 
passed as arguments to the invoked command. The command 
name is passed as argument O (see exec (2)). The value of a 
simple-command is its exit status if it terminates normally, or (octal) 
200+status if it terminates abnormally (see signa/ (2) for a list of 
status values). 


A pipeline is a sequence of one or more commands separated by | 
(or, for historical compatibility, by “~ ). The standard output of each 
command but the last is connected by a pipe (2) to the standard 
input of the next command. Each command is run as a separate 
process; the shell waits for the last command to terminate. The exit 
status of a pipeline is the exit status of the last command. 


A list is a sequence of one or more pipelines separated by ;, & , 
&& , or | | , and optionally terminated by ; or & . Of these four sym- 
bols, ; and & have equal precedence, which is lower than that of && 
and | | . The symbols && and | | also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline; 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does not wait for that pipeline to finish). The 
symbol && (||) causes the /ist following it to be executed only if 
the preceding pipeline returns a zero (non-zero) exit status. An arbi- 
trary number of new-lines may appear in a list , instead of semi- 
colons, to delimit commands. 
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A command is either a simple-command or one of the following. 
Unless otherwise stated, the value returned by a command is that of 
the last simple-command executed in the command. | Se 


for name [ in word ... | do list done 
Each time a for command is executed, name is set to the 
next word taken from the in word list. If in word ... is 
omitted, then the for command executes the do /ist once 
for each positional parameter that is set (see Parameter 
Substitution below). Execution ends when there are no 
more words in the list. 

case word in[ pattern [ | pattern |...) list ;; ]... esac 
A case command executes the /ist associated with the first 
pattern that matches word . The form of the patterns is the 
same as that used for file-name generation (see File Name 
Generation ) except that a slash, a leading dot, or a dot 
immediately following a slash need not be matched expli- 
citly. 

if list then /ist [ elif list then /ist ]...[ else /ist ] fi 
The list following if is executed and, if it returns a zero exit 
status, the /ist following the first then is executed. Other- 
wise, the fist following elif is executed and, if its value is 
zero, the list following the next then is executed. Failing ” 
that, the else /ist is executed. If no else /ist or then list is .. 
executed, then the if command returns a zero exit status. 

while /ist do fist done 
A while command repeatedly executes the while list and, if 
the exit status of the last command in the list is zero, exe- 
cutes the do list ; otherwise the loop terminates. If no com- 
mands in the do list are executed, then the while command 
returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 


(list) 
Execute /ist in a sub-shell. 

{list ;} | 
list is simply executed. 

name () {list;} 
Define a function which is referenced by name. The body of 
the function is the fist of commands between { and }. 
Execution of functions is described below (see Execution ). 


The following words are only recognized as the first word of a com- 
mand and when not quoted: 


if then else elif fi case esac for while until do e - 
done { } Ne 
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a Comments 
( A word beginning with # causes that word and all the following 
Bs characters up to a new-line to be ignored. 


Command Substitution 
The standard output from a command enclosed in a pair of grave 
accents (~ *) may be used as part or all of a word; trailing new-lines 
are removed. 


Parameter Substitution 
The character $ is used to introduce substitutable parameters . 
There are two types of parameters, positional and keyword. If 
parameter is a digit, it is a positional parameter. Positional parame- 
ters may be assigned values by set . Keyword parameters (also 
known as variables) may be assigned values by writing: 


name =value [ name=value ]... 


Pattern-matching is not performed on value . There cannot be a 
function and a variable with the same name . 


${parameter} 
The value, if any, of the parameter is substituted. The 
braces are required only when parameter is followed by a 
letter, digit, or underscore that is not to be interpreted as 
part of its name. If parameter is * or @, all the positional 
parameters, starting with $1 , are substituted (separated by 
spaces). Parameter $0 is set from argument zero when the 
shell is invoked. 

${ parameter :—word} 
lf parameter is set and is non-null, substitute its value; oth- 
erwise substitute word . 

${ parameter := word} 
lf parameter is not set or is null set it to word ; the value of 
the parameter is substituted. Positional parameters may 
not be assigned to in this way. 

${ parameter :?word} 
If parameter is set and is non-null, substitute its value; oth- 
erwise, print word and exit from the shell. If word is omit- 
ted, the message “parameter null or not set” is printed. 

${ parameter :+ word} 
lf parameter is set and is non-null, substitute word ; other- 
wise substitute nothing. 


In the above, word is not evaluated unless it is to be used as the 
~~ substituted string, so that, in the following example, pwd is executed 
( only if d is not set or is null: 
ah 


echo ${d:—* pwd* } 
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If the colon (:) is omitted from the above expressions, the shell only 
checks whether parameter is set or not. 


The following parameters are automatically set by the shell: 
# The number of positional parameters in decimal. 
- Flags supplied to the shell on invocation or by the 
set command. 


? The decimal value returned by the last synchro- 
nously executed command. 

$ The process number of this shell. 

! The process number of the last background com- 


mand invoked. 


The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd 
command. 

PATH The search path for commands (see Execution 
below). The user may not change PATH if execut- 
ing under rsh . 

CDPATH 
The search path for the cd command. 

MAIL If this parameter is set to the name of a mail file 
and the MAILPATH parameter is not set, the shell 
informs the user of the arrival of mail in the speci- 
fied file. 

MAILCHECK 
This parameter specifies how often (in seconds) the 
shell will check for the arrival of mail in the files 
specified by the MAILPATH or MAIL parameters. 
The default value is 600 seconds (10 minutes). If 
set to 0, the shell will check before each prompt. 

MAILPATH 
A colon (:) separated list of file names. If this 
parameter is set, the shell informs the user of the 
arrival of mail in any of the specified files. Each file 
name can be followed by % and a message that will 
be printed when the modification time changes. 
The default message is you have mail . 

PS1 Primary prompt string, by default “$ ”. 

PS2 Secondary prompt string, by default “> ”. 

IFS Internal field separators, normally space , tab , and 
new-line . 

SHACCT 
If this parameter is set to the name of a file writable 
by the user, the shell will write an accounting record 
in the file for each shell procedure executed. 
Accounting routines such as acctcom (1) and 
acctcms (1M) can be used to analyze the data 
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= collected. 
( | SHELL When the shell is invoked, it scans the environment 
L (see Environment below) for this name. If it is 


found and there is an 'r’ in the file name part of its 
value, the shell becomes a restricted shell. 


The shell gives default values to PATH, PS1, PS2, MAILCHECK and 
IFS. HOME and MAIL are set by /ogin (1). 


Blank Interpretation 
After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS ) and split into distinct arguments where such characters are 
found. Explicit null arguments ("" or * 7) are retained. Implicit null 
arguments (those resulting from parameters that have no values) 
are removed. 


File Name Generation 
Following substitution, each command word is scanned for the char- 
acters * , ?, and[ . If one of these characters appears the word is 
regarded as a pattern . The word is replaced with alphabetically 
sorted file names that match the pattern. If no file name is found 
that matches the pattern, the word is left unchanged. The character 
a . at the start of a file name or immediately following a/ , as well as 
( | the character / itself, must be matched explicitly. 


* Matches any string, including the null string. 

? Matches any single character. 

[ ... ] Matches any one of the enclosed characters. A 
pair of characters separated by — matches any 
character lexically between the pair, inclusive. If the 
first character following the opening ~[~° is a “V’ 
any character not enclosed is matched. 


Quoting 
The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 


; & () | * < > new-line space tab 


A character may be quoted (i.e., made to stand for itself) by preced- 
ing it wih a \ . The pair \new-line is ignored. All characters 
enclosed between a pair of single quote marks (7 ~), except a single 
quote, are quoted. Inside double quote marks (""), parameter and 
command substitution occurs and \ quotes the characters \, * , ", 


and $ . "$*" is equivalent to "$1 $2 ...", whereas "$@" is 
, ( = equivalent to "$1" "$2" .... 
2 Prompting 


When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a new-line is typed and 
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further input is needed to complete a command, the ceo = 
prompt (i.e., the value of PS2 ) is issued. | 


Input/Output 
Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command and are not passed on to the invoked com- 
mand; substitution occurs before word or digit is used: 


<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). 
lf the file does not exist it is created; otherwise, it Is 
truncated to zero length. 

>>word Use file word as standard output. If the file exists 
Output is appended to it (by first seeking to the end- 
of-file); otherwise, the file is created. | 

<<[-]word _ The shell input is read up to a line that is the same 
as word , or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character 
of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parame- 
ter and command substitution occurs, (unescaped) .— 
\new-line is ignored, and \ must be used to quote 
the characters \, $, * , and the first character of ~~~ 
word . If — is appended to < , all leading tabs are 
stripped from word and from the document. 

<&digit Use the file associated with file descriptor ofgit as 
standard input. Similarly for the standard output 
using >&digit . 

<&- _ The standard input is closed. Similarly for the stan- 
dard output using >&-. 


If any of the above is preceded by a digit, the file descriptor which 
will be associated with the file is that specified by the digit (instead 
of the default 0 or 1). For example: 


. 2>&!1 
associates file descriptor 2 with the file currently associated with file 
descriptor 1. 


The order in which redirections are specified is significant. The shell 
evaluates redirections left-to-right. For example: 


. 1>xxx 2>&!1 


first associates file descriptor 1 with file xxx . It associates file <— 
descriptor 2 with the file associated with file descriptor 1 (i.e. xxx ). | 
If the order of redirections were reversed, file descriptor 2 would be 
associated with the terminal (assuming file descriptor 1 had been) 
and file descriptor 1 would be associated with file xxx . 
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lf a command is followed by & the default standard input for the 
command is the empty file /dev/null . Otherwise, the environment 
for the execution of a command contains the file descriptors of the 
invoking shell as modified by input/output specifications. 


Redirection of output is not allowed in the restricted shell. 


Environment 

The environment (see environ (5)) is a list of name-value pairs that 
is passed to an executed program in the same way as a normal 
argument list. The shell interacts with the environment in several 
ways. On invocation, the shell scans the environment and creates a 
parameter for each name found, giving it the corresponding value. 
If the user modifies the value of any of these parameters or creates 
new parameters, none of these affects the environment unless the 
export command is used to bind the shell’s parameter to the 
environment (see also set -a ). A parameter may be removed from 
the environment with the unset command. The environment seen 
by any executed command is thus composed of any unmodified 
name-value pairs originally inherited by the shell, minus any pairs 
removed by unset , plus any modifications or additions, all of which 
must be noted in export commands. 


The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 


TERM=450 cmd and 
(export TERM; TERM=450; cmd) 


are equivalent (as far as the execution of cmd is concerned). 


If the —k flag is set, all keyword arguments are placed in the 
environment, even if they occur after the command name. The fol- 
lowing first prints a=b c andc: 


echo a=bc 
set —k 
echo a=bc 


Signals 
The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by & ; otherwise signals have 
the values inherited by the shell from its parent, with the exception 
of signal 11 (but see also the trap command below). 


Execution 
Each time a command is executed, the above substitutions are car- 
ried out. If the command name matches one of the Special Com- 
mands listed below, it is executed in the shell process. If the com- 
mand name does not match a Speciai Command , but matches the 
name of a defined function, the function is executed in the shell pro- 
cess (note how this differs from the execution of shell procedures). 
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The positional parameters $1, $2, .... are set to the arguments of 
the function. If the command name matches neither a Special / 
Command nor the name of a defined function, a new process is «_” 
created and an attempt is made to execute the command via exec 
(2). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin , and /usr/bin , in that order). Note that the 
current directory is specified by a null path name, which can appear 
immediately after the equal sign or between the colon delimiters 
anywhere else in the path list. If the command name contains a / 
the search path is not used; such commands will not be executed 
by the restricted shell. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission 
but is not an a.out file, it is assumed to be a file containing shell 
commands. A sub-shell is spawned to read it. A parenthesized 
command is also executed in a sub-shell. 


The location in the search path where a command was found Its 
remembered by the shell (to help avoid unnecessary execs later). 

lf the command was found in a relative directory, its location must 
be re-determined whenever the current directory changes. The 
shell forgets all remembered locations whenever the PATH variable ~—~ 
is changed or the hash -r command is executed (see below). 


If you invoke a shell whose exit status you assign to a local variable 
and the shell you invoke runs a process in background, the invoked 
shell will not return until the background process has completed 


Special Commands 
Input/output redirection is now permitted for these commands. File 
descriptor 1 is the default output location. 


No effect; the command does nothing. A zero exit code is 
returned. 

. file Read and execute commands from file and return. The 
search path specified by PATH is used to find the directory 
containing file . 

break [ 7 | 
Exit from the enclosing for or while loop, if any. If n is 
specified break rn levels. 

continue [ 7 | 

| Resume the next iteration of the enclosing for or while 

loop. Ifn is specified resume at the n -th enclosing loop. ( 

cd[ arg | Bk 
Change the current directory to arg . The shell parameter 
HOME is the default arg . The shell parameter CDPATH 
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defines the search path for the directory containing arg . 
Alternative directory names are separated by a colon (:). 
The default path is <null> (specifying the current direc- 
tory). Note that the current directory is specified by a null 
path name, which can appear immediately after the equal 
sign or between the colon delimiters anywhere else in the 
path list. If arg begins with a / the search path is not used. 
Otherwise, each directory in the path is searched for arg . 
The cd command may not be executed by rsh. 

echo[ arg... | 
Echo arguments. See echo (7) for usage and description. 

eval[ arg... | 
The arguments are read as input to the shell and the result- 
ing command(s) executed. 

exec[ arg... | 
The command specified by the arguments is executed in 
place of this shell without creating a new process. 
Input/output arguments may appear and, if no other argu- 
ments are given, cause the shell input/output to be modi- 
fied. 

exit [ n | 
Causes a shell to exit with the exit status specified by n. If 
n is omitted the exit status is that of the last command exe- 
cuted (an end-of-file will also cause the shell to exit.) 

export [ name... | 
The given name s are marked for automatic export to the 
environment of subsequently-executed commands. If no 
arguments are given, a list of all names that are exported in 
this shell is printed. Function names may not be exported. 

hash [ -r ][ name... | 
For each name , the location in the search path of the com- 
mand specified by name is determined and remembered by 
the shell. The -r option causes the shell to forget all 
remembered locations. If no arguments are given, informa- 
tion about remembered commands is presented. Hits is the 
number of times a command has been invoked by the shell 
process. Cost is a measure of the work required to locate a 
command in the search path. There are certain situations 
which require that the stored location of a command be 
recalculated. Commands for which this will be done are 
indicated by an asterisk (*) adjacent to the Aits information. 
Cost will be incremented when the recalculation is done. 

newgrp | arg... | | 
Equivalent to exec newgrp arg .... See newgrp (7) for 
usage and description. 
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pwd = Print the current working directory. See pwd (7) for usage 
and description. | 

read[ name... ] « 
One line is read from the standard input and the first word is 
assigned to the first name , the second word to the second 
name , etc., with leftover words assigned to the last name . 
The return code is 0 unless an end-of-file is encountered. 

readonly [ name... | 
The given name s are marked readonly and the values of 
the these name s may not be changed by subsequent 
assignment. If no arguments are given, a list of all readonly 
names is printed. 

return [ 7 | 
Causes a function to exit with the return value specified by 
n. If nis omitted, the return status is that of the last com- 
mand executed. 

set [| —aefhkntuvx [ arg... ] ] 


—a Mark variables which are modified or created for 
export. 

—e Exit immediately if a command exits with a non-zero 

| exit status. 

—f Disable file name generation i 

—h Locate and remember function commands as func- : 


tions are defined (function commands are normally ~~~ 
located when the function is executed). 

—k All keyword arguments are placed in the environ- 
ment for a command, not just those that precede 
the command name. 


-n = Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

—X Print commands and their arguments as they are 
executed. | 

— Do not change any of the flags; useful in setting $1 
to - 


Using + rather than — causes hese flags to be turned off. 
These flags can also be used upon invocation of the shell. 
The current set of flags may be found in $- . The remaining 
arguments are positional parameters and are assigned, in 


order, to $1, $2, .... If no arguments are given the values 
of all names are printed. 

shift [ 2 ] f 
The positional parameters from $n+1... are renamed $1 \ 


. If is not given, it is assumed to be 1. 
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test 
Evaluate conditional expressions. See test (7) for usage 
and description. 


times 
Print the accumulated user and system times for processes 
run from the shell. 

trap[ arg |[n]... 
The command arg is to be read and executed when the 
shell receives signal(s) n . (Note that arg is scanned once 
when the trap is set and once when the trap is taken.) Trap 
commands are executed in order of signal number. Any 
attempt to set a trap on a signal that was ignored on entry | 
to the current shell is ineffective. An attempt to trap on sig- 
nal 11 (memory fault) produces an error. If arg is absent all 
trap(s) n are reset to their original values. If arg is the null 
string this signal is ignored by the shell and by the com- 
mands it invokes. If n is 0 the command arg is executed on 
exit from the shell. The trap command with no arguments 
prints a list of commands associated with each signal 


number. 
type [ name... | 
oN For each name , indicate how it would be interpreted if used 
( ) as a command name. 
om ulimit [ -fp | [7 |] 
‘imposes a size limit of n 
—f imposes a size limit of n blocks on files written by 


child processes (files of any size may be read). 
With no argument, the current limit is printed. 
If no option is given, -f is assumed. 
umask [ nnn | 
| The user file-creation mask is set to nnn (see umask (2) ). If 
nnn is omitted, the current value of the mask is printed. 
unset [ name... ] 
For each name , remove the corresponding variable or func- 
tion. The variables PATH, PS1, PS2, MAILCHECK and IFS 
cannot be unset. 
wait [n | 
Wait for the specified process and report its termination 
status. If nm is not given all currently active child processes 
are waited for and the return code is zero. 


Invocation 

a If the shell is invoked through exec (2) and the first character of 
argument zero is — , commands are initially read from /ete/profile 
: and from $HOME/.profile , if such files exist. Thereafter, commands 

are read as described below, which is also the case when the shell 

is invoked as /bin/sh . The flags below are interpreted by the shell 
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on invocation only; Note that unless the —c or —s flag is specified, 


the first argument is assumed to be the name of a file containing - co 


commands, and the remaining arguments are passed as positional ‘ 
parameters to that command file: 


—c string lf the -c flag is present commands are read from string . 

-Ss lf the —s flag is present or if no arguments remain com- 
mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell out- 
put (except for Special Commands ) is written to file 
descriptor 2. 

—j If the —i flag is present or if the shell input and output are 
attached to a terminal, this shell is interactive . In this 
case TERMINATE is ignored (so that kill 0 does not kill 
an interactive shell) and INTERRUPT is caught and 
ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

—r If the —r flag is present the shell is a restricted shell. 


The remaining flags and arguments are described under the set 
command above. 


Rsh Only 


_Rsh is used to set up login names and execution environments 


whose capabilities are more controlled than those of the standard 
shell. The actions of rsh are identical to those of sh , except that 
the following are disallowed: 

changing directory (see cd (1)), 

setting the value of $PATH, 

specifying path or command names containing / , 

redirecting output (> and >> ). 


The restrictions above are enforced after .profile is interpreted. 


When a command to be executed is found to be a shell procedure, 
rsh invokes sh to execute it. Thus, it is possible to provide to the 
end-user shell procedures that have access to the full power of the 
standard shell, while imposing a limited menu of commands; this 
scheme assumes that the end-user does not have write and exe- 
cute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has 
complete control over user actions, by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably 
not the login directory). 


The system administrator often sets up a directory of commands 
(i.e., /usr/rbin ) that can be safely invoked by rsh . Some systems 
also provide a restricted editor red . 
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EXIT STATUS 
fp Errors detected by the shell, such as syntax errors, cause the shell 
Ee to return a non-zero exit status. If the shell is being used non- 


interactively execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed (see also 
the exit command above). 


FILES 
/etc/profile 
$HOME/. profile 
/tmp/sh* 
/dev/null 
SEE ALSO 
acctcom(1), ¢d(1), echo(1), env(1), login(1), newgrp(1), pwd(1), 
test(1), umask(1). 
acctcms(1M) in the Sys5 UNIX Administrator Reference Manual. 
dup(2), exec(2), fork(2), pipe(2), signal(2), ulimit(2), umask(2), 
wait(2), a,out(4), profile(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 
CAVEATS 
lf a command is executed, and a command with the same name is 
aes installed in a directory in the search path before the directory where 
( } the original command was found, the shell will continue to exec the 


Original command. Use the hash command to correct this situation. 


If you move the current directory or one above it, pwd may not give 
the correct response. Use the cd command with a full path name to 
correct this situation. 
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NAME 
size — print section sizes of common object files a 
SYNOPSIS - | So... 
size [—o] [-x] [-V] files : 
DESCRIPTION 


The size command produces section size information for each sec- 
tion in the common object files. The size of the text, data and bss 
(uninitialized data) sections are printed along with the total size of 
the object file. If an archive file is input to the size command the 
information for all archive members is displayed. 


Numbers will be printed in decimal unless either the —o or the —x 
option is used, in which case they will be printed in octal or in hexa- 
decimal, respectively. 


The —V flag will supply the version information on the size com- 
mand. 
SEE ALSO . 
as(1), cc(1), Id(1). 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS 
size: name: cannot open — 
if name cannot be read. 
size: name: bad magic 
if name is not an appropriate common object file. 
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NAME 

sleep — suspend execution for an interval 
SYNOPSIS 

sleep time 
DESCRIPTION 


Sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time, as in: 


(sleep 105; command)& 
or to execute a command every so often, as in: 


while true 
do 
command 
Sleep 37 
done 


SEE ALSO 
alarm(2), sleep(3C) in the Sys5 UNIX Programmer Reference 
Manual. 


Page 1 May 27, 1985 


SNO(1)- 


NAME 


UNIX Sys5 SNO(1) 


sno — SNOBOL interpreter 


SYNOPSIS 


sno [ files | 


DESCRIPTION 


Sno is a SNOBOL compiler and interpreter (with slight differences). 
Sno obtains input from the concatenation of the named file s and 
the standard input. All input through a statement containing the 
label end is considered program and is compiled. The rest is avail- 
able to syspit . 


Sno differs from SNOBOQL in the following ways: 
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There are no unanchored searches. To get the same 
effect: 


a ** 6 | unanchored search for b. 
a *x* b = XC uNnanchored assignment 


There is no back referencing. 


Xx — "abc" 
a *X* X iS an unanchored search for abc 


Function declaration is done at compile time by the use of 
the (non-unique) label define . Execution of a function call 
begins at the statement following the define . Functions 
cannot be defined at run time, and the use of the name 
define is preempted. There is no provision for. automatic 
variables other than parameters. Examples: 


define f( ) 

define f(a, b, c) 
All labels except define (even end ) must have a non-empty 
statement. 


Labels, functions and variables must all have distinct 
names. In particular, the non-empty statement on end can- 
not merely name a label. 


lf start is a label in the program, program execution will 
start there. If not, execution begins with the first executable 
statement; define is not an executable statement. 


There are no built-in functions. 


Parentheses for arithmetic are not needed. Normal pre- 
cedence applies. Because of this, the arithmetic operators / 
and * must be set off by spaces. 
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The right side of assignments must be non-empty. 


Either ’ or “ may be used for literal quotes. 
The pseudo-variable sysppt is not available. 


SEE ALSO 
awk(1). 
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NAME 2 | _ 
sort — sort and/or merge files. | 


SYNOPSIS | | Peas a _ oo 
sort [-cmu] [-ooutput] [-ykmem] [-zrecsz] [—dfiMnr] [—btx] 
[+pos1 [-pos2]] [files] | 


DESCRIPTION 
Sort sorts lines of all the named files together and writes the result 
on the standard output. The standard input is read if — is used as a 
file name or no input files are named. 


Comparisons are based on one or more sort keys extracted from 
each line of input. By default, there is one sort key, the entire input 
line, and ordering is lexicographic by bytes in machine collating 
sequence. 


The following options alter the default behavior: 


-—c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. 


-—m Merge only, the input files are already sorted. 


—u Unique: suppress all but one in each set of lines having equal 
keys. 


—ooutput 
The argument given is the name of an output file to use 
instead of the standard output. This file may be the same as 
one of the inputs. There may be optional blanks between —o 
and output. 


-ykmem 

The amount of main memory used by the sort has a large 
impact on its performance. Sorting a small file in a large 
amount of memory is a waste. If this option is omitted, sort 
begins using a system default memory size, and continues to 
use more space as needed. If this option is presented with a 
value, kmem , sort will start using that number of kilobytes of 
memory, unless the administrative minimum or maximum is 
violated, in which case the corresponding extremum will be 
used. Thus, -y Q is guaranteed to start with minimum 
memory. By convention, -y (with no argument) starts with 
maximum memory. 


—Zrecsz | 

The size of the longest line read is recorded in the sort phase 
so buffers can be allocated during the merge phase. If the 
sort phase is omitted via the -—c or —m options, a popular 
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system default size will be used. Lines longer than the buffer 
size will cause sort to terminate abnormally. Supplying the 
actual number of bytes in the longest line to be merged (or 
some larger value) will prevent abnormal termination. 


The following options override the default ordering rules. 


-d “Dictionary” order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. 


-~f Fold lower case letters into upper case. 


-i Ignore characters outside the ASCII range 040-0176 in non- 
numeric comparisons. 


—M Compare as months. The first three non-blank characters of | 
the field are folded to upper case and compared so that “JAN” 
< “FEB” <... < “DEC”. Invalid fields compare low to “JAN”. 
The —M option implies the —b option (see below). 


-n_ An initial numeric string, consisting of optional blanks, optional 
minus sign, and zero or more digits with optional decimal 
point, is sorted by arithmetic value. The —n option implies the 
—b option (see below). Note that the —b option is only effec- 
tive when restricted sort key specifications are in effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key specifica- 
tions, the requested ordering rules are applied globally to all sort 
keys. When attached to a specific sort key (described below), the 
specified ordering options override all global ordering options for that 
key. 


The notation +pos? —pos2 restricts a sort key to one beginning at 
pos? and ending at pos2 . The characters at positions pos? and 
pos2 are included in the sort key (provided that pos2 does not pre- 
cede pos? ). A missing —pos2 means the end of the line. 


Specifying pos? and pos2 involves the notion of a field, a minimal 
sequence of characters followed by a field separator or a new-line. 
By default, the first blank (space or tab) of a sequence of blanks 
acts as the field separator. All blanks in a sequence of blanks are 
considered to be part of the next field; for example, all blanks at the 
beginning of a line are considered to be part of the first field. The 
treatment of field separators can be altered using the options: 


-tx Use x as the field separator character; x is not considered to 
be part of a field (although it may be included in a sort key). 
Each occurrence of x is significant (e.g., xx delimits an empty 
field). 
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-b Ignore leading blanks when determining the starting and end- 


ing positions of a restricted sort key. If the —b option is speci- | 


fied before the first +pos7 argument, it will be applied to all 
+ pos? arguments. Otherwise, the b flag may be attached 
independently to each + pos? or —pos2 argument (see below). 


Pos? and pos2 each have the form m.n optionally followed by one 
or more of the flags bdfinr . A starting position specified by +m.n is 
interpreted to mean the n + 1st character in the m + 1st field. A 
missing .. means . Q, indicating the first character of the m + 1st 
field. If the b flag is in effect n is counted from the first non-blank in 
the m +1st field; +m.0b refers to the first non-blank character in 
the m + 1st field. 


A last position specified by —m.n is interpreted to mean the n th 
character (including separators) after the last character of the m th 
field. A missing .n means . 0, indicating the last character of the m 
th field. If the b flag is in effect n is counted from the last leading 
blank in the m + 1st field; -m.1b refers te the first non-blank in the 
m + 1st field. 


When there are multiple sort keys, later keys are compared only 
after all earlier keys compare equal. Lines that otherwise compare 
equal are ordered with all bytes significant. 


EXAMPLES 
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Sort the contents of infile with the second field as the sort key: 
sort +1 —2 infile 


Sort, in reverse order, the contents of infile? and infile2 , placing the 
output in outfile and using the first character of the second field as 
the sort key: 


sort —r —o outfile + 1.0 —1.2 infile1 infile2 


sort, in reverse order, the contents of infile1 and intile2 using the 
first non-blank character of the second field as the sort key: 


sort —r + 1.0b —1.1b infile1 infile2 


Print the password file (passwd(4)) sorted by the numeric user ID 
(the third colon-separated field): : | 


sort -t: +2n —3 /etc/passwd 
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all but the first occurrence of lines having the same third 
field (the options -um with just one input file make the 
choice of a unique representative from a set of equal lines 


( Print the lines of the already sorted file infile , suppressing 
q 


predictable): 
sort -um +2 -—3 infile 
FILES 
/usr/tmpstm??? 
SEE ALSO 
comm(1), join(1), uniq(1). 
DIAGNOSTICS 


Comments and exits with non-zero status for various trouble condi- 
tions (e.g., when input lines are too long), and for disorder 
discovered under the —c option. When the last line of an input file is 
missing a new-line character, sort appends one, prints a warning 
message, and continues. 


(. 
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NAME | 


spell, hashmake, spellin, hashcheck — find spelling errors 


SYNOPSIS. 


spell [-v ] [-b][-x ][-l] [-i][ + local_file ] [ files ] 
/usr/lib/spell/hashmake 

/usr/lib/spell/spellin n 

/usr/lib/spell/hashcheck spelling_list 


DESCRIPTION 
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Spell collects words from the named files and looks them up in a 
spelling list. Words that neither occur among nor are derivable (by 
applying certain inflections, prefixes, and/or suffixes) from words in 
the spelling list are printed on the standard output. If no files are 
named, words are collected from the standard input. 


Spell ignores most troff (1), tb! (1), and eqn (1) constructions. 


Under the -—v option, all words not literally in the spelling list are 
printed, and plausible derivations from the words in the spelling list 
are indicated. 


Under the —b option, British spelling is checked. Besides preferring 
centre , colour , programme , speciality , travelled , etc., this option 
insists upon -ise in words like standardise , Fowler and the OED to 
the contrary notwithstanding. 


Under the —x option, every plausible stem is printed with = for each 
word. 


By default, spel! (like deroff (1)) follows chains of included files (.so 
and .nx troff (1) requests), unless the names of such included files 
begin with /usr/lib . Under the -I option, spel! will follow the chains 
of all included files. Under the -i option, spe! will ignore all chains 
of included files. 


Under the +/ocal_file option, words found in /ocal_file are removed 
from spell ’s output. Local_file is the name of a user-provided file 
that contains a sorted list of words, one per line. With this option, 
the user can specify a set of words that are correct spellings (in 
addition to spell ’s own spelling list) for each job. 


The spelling list is based on many sources, and while more hapha- 
zard than an ordinary dictionary, is also more effective with respect 
to proper names and popular technical words. Coverage of the spe- 
cialized vocabularies of biology, medicine, and chemistry is light. 


Pertinent auxiliary files may be specified by name arguments, indi- 
cated below with their default settings (see FILES ). Copies of all 
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— output are accumulated in the history file. The stop list filters out 
( misspellings (e.g., thier: thy—y+ ier) that would otherwise pass. 


Three routines help maintain and check the hash lists used by spell 


hashmake ~~ Reads a list of words from the standard input and 
writes the corresponding nine-digit hash code on the 
standard output. 


spellin n Reads n hash codes from the standard input and 
writes a compressed spelling list on the standard out- 
put. Information about the hash coding is printed on 
standard error. 


hashcheck Reads a compressed spelling_list and recreates the 
nine-digit hash codes for all the words in tt; it writes 
these codes on the standard output. 


EXAMPLES 
The following example creates the hashed spell list hlist and checks 
the result by comparing the two temporary files; they should be 
equal. 


cat goodwds | ‘usr. lib;spell/hashmake | sort -u >tmp1 
cat tmp1 | /usr/lib/spell/spellin «cat tmp1 | we -Is >hlist 
cat hlist | /usr/lib/spell/hashcheck >tmp2 

diff tmp1 tmp2 


FILES 
D_SPELL=/usr/lib/spell/hlisttab] | hashed spelling lists, American & 
British 
S_SPELL=-usr/libsspell/hstop hashed stop list 
H SPELL=-usr/libsspellispellhist history file 
/usrilib/spell/spellprog program 
SEE ALSO 
deroff(1), eqn(1), sed(1), sort(1), tbl(1), tee(1), troff(1). 
BUGS 


The spelling list’s coverage is uneven; new installations will probably 
wish to monitor the output for several months to gather local addi- 
tions; typically, these are kept in a separate local file that is added 
to the hashed spelling_list via spellin . 

The British spelling feature was done by an American. 


© 
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NAME : oe 
- spline — interpolate smooth curve 


SYNOPSIS 
spline [ options | 


DESCRIPTION 

- Spline takes pairs of numbers from the standard input as abscissas 
and ordinates of a function. It produces a similar set, which is 
approximately equally spaced and includes the input set, on the 
standard output. The cubic spline output (R. W. Hamming, “Numeri- 
cal Methods for Scientists and Engineers" , 2nd ed., pp. 349ff) has 
two continuous derivatives, and sufficiently many points to look 
smooth when plotted, for example by graph (1G). 


The following options are recognized, each as a separate argument: 


—a Supply abscissas automatically (they are missing from the 
input); spacing is given by the next argument, or is assumed 
to be 1 if next argument is not a number. 


~—k The constant k used in the boundary value computation: 
Yo =KY,, Va = KV 4 
is set by the next argument (default k = 0). - 
—n Space output points so that approximately n intervals occur : 
between the lower and upper x limits (default m = 100). * 


—p Make output periodic, i.e., match derivatives at ends. First 
and last input values should normally agree. 


—X Next 1 (or 2) arguments are lower (and upper) x limits. 
Normally, these limits are calculated from the data. 
Automatic abscissas start at lower limit (default 0). 


SEE ALSO 
graph(1G). 


DIAGNOSTICS 
When data is not strictly monotone in x , spline reproduces the 
input without interpolating extra points. 


BUGS 
| A limit of 1,000 input points is enforced silently. 
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NAME 
split — split a file into pieces 
} 
SYNOPSIS 
split [ —n ] [ file [ name ] ] 
DESCRIPTION | 
Split reads file and writes it in n -line pieces (default 1000 lines) onto 
a set of output files. The name of the first output file is name with 
aa appended, and so on lexicographically, up to zz (a maximum of 
676 files). Name cannot be longer than 12 characters. If no output 
name is given, x is default. 
If no input file is given, or if — is given in its stead, then the standard 
input file is used. 
SEE ALSO 
bfs(1), csplit(1). 
( ) 
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NAME 

sroff — format text 
SYNOPSIS 

sroff [ options | [ files ] 
DESCRIPTION | 

Sroff formats text contained in files (standard input by default) for 

printing on typewriter-like devices and line printers, including the 

XEROX 9700 printer. 

An argument consisting of a minus (—) is taken to be a file name 

corresponding to the standard input. The options, which may 

appear in any order, but must appear before the files, are: 

—Olist Print only pages whose page numbers appear in the /ist 
of numbers and ranges, separated by commas. A range 
N-M means pages N through M; an initial -N means 
from the beginning to page N; and a final N— means from 
N to the end. 

—sN Stop every N pages. Sroff will halt after every N pages 
(default N=1) to allow paper loading or changing, and will 
resume upon receipt of a line-feed or new-line. | 

—-mname Prepend to the input files the macro file 
/usr/lib/smac/mname. (None available so far. Develop- 
ment of an MM-like macro package for sroff is in pro- 
gress.) 

—xfile Write any index information onto file. 

SEE ALSO 
——— col(t), pg(1). 
BUGS 
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%# is the name of a register that contains the number of lines used 
on a page in single-column mode, or the number of lines in a diver- 
sion. %# should work in multi-column mode, but what should it 
count? 
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NAME | 
stat — statistical network useful with graphical commands _ 


SYNOPSIS 
node-name [options] [files] 


DESCRIPTION : 
Stat is a collection of command level functions (nodes) that can be 
_ interconnected using sh (17) to form a statistical network. The nodes 
reside in /usr/bin/graf (see graphics (1G)). Data is passed through 
the network as sequences of numbers (vectors), where a number is 

of the form: - 


[sign](digits)(.digits)[e[sign]digits] 


evaluated in the usual way. Brackets and parentheses surround 

fields. All fields are optional, but at least one of the fields sur- 

rounded by parentheses must be present. Any character input to a 
~ node that is not part of a number is taken as a delimiter. 


Stat nodes are divided into four classes. 


Transformers, which map input vector elements into 
output vector elements; 

Summarizers, which calculate statistics of a vector; 

Translators, which convert among formats; and 

Generators, which are sources of definable vectors. 


Below is a list of synopses for stat nodes. Most nodes accept 
options indicated by a leading minus (—). In general, an option is 
specified by a character followed by a value, such as c5. This is 
interpreted as c := 5 (c is assigned 5). The following keys are used 
to designate the expected type of the value: 


Cc characters, 

i integer, 

f floating point or integer, 
file file name, and 


string — string of characters, surrounded by quotes to include 
a Shell argument delimiter. 


Options without keys are flags. All nodes except generators accept 
files as input, hence it is not indicated in the synopses. 


_ Transformers : 


abs [-—c/] — absolute value 
columns (similarly for —c options that follow) 
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SummMarizers : 
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ceil 
cusum 
exp 
floor 
gamma 


list 


log 


mod 


pair 


power 


root 


round 


siline 


sin 


subset 


bucket 
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—ci tv | — arithmetic function 
itled output, v erbose 


—c/] — round up to next integer 


[ 

t 

[-ci] — cumulative sum 

[-c/] — exponential 
[-c/] — round down to next integer 
[-ci] — gamma 


[-—ci dstring | — list vector elements 
d elimiter(s) 

[-ci bf ] — logarithm 

base 


[—ci mf | — modulus 
modulus 


[-ci Ffile xi] — pair elements 
File containing base vector, x group size 


[-c/ pf] - 
power 


raise to a power 


[-ci rf | — take a root 

root 

[-c/ p/ si ] — round to nearest integer, .5 rounds to 
1 


p laces after decimal point, s ignificant digits 


[-c/i if nisf ] — generate a line given slope and inter- 
cept 

intercept, n umber of positive integers, s lope 
[-ci] — sine 

[-af bf ci Ffile ii If nl np pf si ti] — generate a sub- 
set 

above, below, File with master vector, interval, 


leave, master contains element numbers to master 
contains element numbers to pick, start, terminate 


[-a/ ci Ffile hf iv If ni] — break into buckets 

average size, File. containing bucket boundaries, 
high, interval, low, number 

Input data should be sorted 
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cor 


hilo 


lreg 


mean 


point 


prod 
qsort 
rank 
total 
var 


Translators : 


bar 


hist 


label 
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[-Ffile | — correlation coefficient | a 
File containing base vector ‘ 

— 
[—- h 1 0 ox oy |- find high and low values 
h igh only, | ow only, o ption form, o ption 
form with x prepended, o ption form with y 
prepended 
[-Ffile io s ] — linear regression 
F ile containing base vector, i ntercept only, o 
ption form for siline, slope only 
[-ff ni pf ] — (trimmed) arithmetic mean 
fraction, number, percent 
[-ff ni pf s ] — point from empirical cumulative den- 
sity function 
fraction, number, percent, sorted input 
— internal product 
[-c/] — quick sort 
— vector rank 
— sum total 
— variance . 
[-a b f g ri wi xf xa yf ya ylf yhf | — build a bar 
chart 
Suppress axes, bold, suppress .}f rame, suppress 
grid, region, idth in percent, x origin, suppress .}f 
xis label, y origin, suppress y xis label, y-axis lower 
bound, -axis high bound 
Data is rounded off to integers. 
[-a b f g ri xf xa yf ya ylf yhf | — build a histo- 
gram 
suppress axes, bold, suppress .}f rame, Suppress 
grid, region, origin, suppress x-axis label, y origin, 
suppress y xis label, y-axis lower bound, -axis high 
bound 
[-b c Ffile h p ri x xu y yr] — label the axis of a 
GPS file 
b ar chart input, retain c ase, label F ile, h isto- 
gram input, p lot input, r otation, x -axis, u ic 
pper x -axis, y -axis, right y -axis 
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pie 


plot 


title 


o~ 
-— Generators : 


gas 


prime 


rand 


RESTRICTIONS 
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[-b o p pr ppi r/ v xi y/ | — build a pie chart 
b old, values o utside pie, value as p ercen- 
tage(: - 100), value as p ercentage(:=i), draw p 
ercent of p ie, region, no v alues, x origin, y 
origin 
Unlike other nodes, input is lines of the form 
[< ie fcc >] value [label] 
i gnore (do not draw) slice, e xplode slice, 
f ill slice, c olor slice c =(b lack, red,g 
reen, bl u e) 


[-a b cstringd f Ffile xf xa xif xhf xf xnixt 
yf ya yif yhf ylf yn/ yt | — plot a graph 

suppress axes, bold, plotting .;f haracters, discon- 
nected, suppress ile containing x vector, suppress 
grid, mark points, region, x origin, suppress X-axis 
label, x interval, x h igh bound, x low bound, 
number -axis, suppress x-axis title, y origin, 
suppress y-axis label, y interval, y h igh bound, y 
low bound, number -axis, suppress y-axis title 


[-b c Istring vstring u ] — title a vector or a GPS 
title bold, retain case, lower title, upper title, vector 


[-c/ if ni sf tf] — generate additive sequence 
interval, number, start, terminate 


[-c/ hv li nv | — generate prime numbers 
high, low, number 


[-ci hf If mf ni si] — generate random sequence 
high, low, multiplier, number, seed 


Some nodes have a limit on the size of the input vector. 


SEE ALSO 


graphics(1G). 


gps(4) in the Sys5 UNIX Programmer Reference Manual. 


ae 
M, 
q “ 
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NAME — | > 
strings — find the printable strings in a object, or other binary, file 
SYNOPSIS | _ 
 /usr/plx/strings [ - ] [ -o ] [ -number ] file ... 
DESCRIPTION — 


Strings looks for ASCII strings in a binary file. A string is any 
sequence of 4 or more printing characters ending with a newline or 
a null. Unless the — flag is given, strings only looks in the initialized 
data space of object files. If the —o flag is given, then each string is 
preceded by its offset in the file (in octal). If the -number flag is 
given then number is used as the minimum string length rather than 
4. 


Strings is useful for identifying random object files and many other 
things. 


NOTES | 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. | | 


SEE ALSO 
od(1) 


BUGS 
The algorithm for identifying strings is extremely primitive. 
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NAME 


strip — strip symbol and line number information from a common 
object file 


SYNOPSIS 


strip [-I] [-x] [-r] [-V] filename 


DESCRIPTION 


FILES 


The strip command strips the symbol table and line number informa- 
tion from common object files, including archives. Once this has 
been done, no symbolic debugging access will be available for that 
file; therefore, this command is normally run only on production 
modules that have been debugged and tested. 


The amount of information stripped from the symbol table can be | 
controlled by using any of the following options: 


I Strip line number information only; do not strip any symbol 
table information. 


—X Do not strip static or external symbol information. 
-r Reset the relocation indexes into the symbol table. 
~V Print the version of the strip command executing on the 


standard error output. 


If there are any relocation entries in the object file and any symbol 
table information is to be stripped, strip will complain and terminate 
without stripping file-name unless the -r flag is used. 


If the strip command is executed on a common archive file (see ar 
(4)) the archive symbol table will be removed. The archive symbol 
table must be restored by executing the ar (1) command with the s 
option before the archive can be link-edited by the /d (1) command. 
Strip will instruct the user with appropriate warning messages when 
this situation arises. 


The purpose of this command is to reduce the file storage overhead 
taken by the object file. 


SEE ALSO 


ar(1), as(1), cc(1), Id(1). 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 
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strip: name: cannot open 
if name cannot be read. 
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strip: name: bad magic wes 


if name is not an appropriate common | 
object file. | ees 


strip: name: relocation entries present; cannot strip 
if name contains relocation entries and 
the -r flag is not used, the symbol table informa- 
tion cannot be stripped. 
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NAME 


& ‘synopsis 


stty — set the options for a terminal 


stty [ -f <fty-device> | [ -a ] [ -g ] [ options ] 


DESCRIPTION 
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Stty sets certain terminal /O options for the device that is the 
current standard input; without arguments, it reports the settings of 
certain options; with the —a option, it reports all of the option set- 
tings; with the —g option, it reports current settings in a form that 
can be used as an argument to another sity command. With the —f 
option, the current standard input is not used, but the specified 
tty_device is opened with NDELAY specified and the subsequent 
argument operations are applied to the specified fty-device. The —-f 
option must be specified first (with its device name, separate from 
other options). Detailed information about the modes for asynchro- 
nous lines listed in the first five groups below may be found in ftty(7) 
in the UNIX System Administrator Reference Manual. Options in 
the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, 
but no sanity checking is performed. The options are selected from 
the following: 


Control Modes 


parenb (-parenb) enable (disable) parity generation and detec- 
tion. 
parodd ( —parodd ) 
select odd (even) parity. 
CSS cs6 cs7 cs8 
select character size (see fty(7)). 
0 hang up phone line immediately. 
50 75 110 134 150 
200 300 600 1200 
1800 2400 4800 
9600 19200 exta extb 
Set terminal baud rate to the number given, if possible. (All 
speeds are not supported by all hardware interfaces.) 
hupcl ( —hupcl ) 
hang up (do not hang up) DATA-PHONE® connection on last 
close. 
hup (—hup ) | 
same as hupcl ( —hupcl ). 
cstopb ( —cstopb ) 
use two (one) stop bits per character. 
cread (-—cread ) 
enable (disable) the receiver. 
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clocal (—clocal ) 

assume a line without (with) modem control. eo 
lobIk ( —loblk ) 

block (do not block) output from a non-current layer. 


Input Modes 
ignbrk (—ignbrk ) — ignore (do not ignore) break on input. 
brkint ( —brkint ) 
signal (do not signal) INTR on break. 
ignpar (-—ignpar ) 
ignore (do not ignore) parity errors. 
parmrk (—parmrk ) 
mark (do not mark) parity errors (see tty(7)). 
inpck (—-inpck ) 
enable (disable) input parity checking. 
istrip (—istrip ) 
strip (do not strip) input characters to seven bits. 
inlcr (—-inlcr ) 
map (do not map) NL to CR on input. 
igner (-igner ) 
ignore (do not ignore) CR on input. 
icrnl (—-icrnl ) 
map (do not map) CR to NL on input. 
iucic (-—iuclc ) 
map (do not map) upper-case alphabetics to lower case on 
input. 
ixon ({-—ixon ) 
enable (disable) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by sending an 
ASCII DC1. 
ixany (-ixany ) 
allow any character (only DC1) to restart output. 
ixoff ( —ixoff ) 
request that the system send (not send) START/STOP char- 
acters when the input queue is nearly empty/full. 
icts (-icts ) 
Use the Clear To Send line to determine the status of the 
input queue as above. Clear To Send is on when high. 
ictslo ( -ictslo ) 
Same as icts except Clear To Send is on when low. 


Output Modes 
opost ( —opost ) post-process output (do not post-process out- =. | 
put; ignore all other output modes). 
olcuc ( -olcuc ) 
map (do not map) lower-case alphabetics to upper case on 
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output. 
onicr (—onlcr ) 

map (do not map) NL to CR-NL on output 
ocrnl (—ocrnl ) 

map (do not map) CR to NL on Bui 
onocr ( —onocr ) 

do not (do) output CRs at column zero. 
onlret (—onlret ) 

on the terminal NL performs (does not perform) the CR func- 

tion. 
ofill ( —ofill ) 

use fill characters (use timing) for delays. 
ofdel ( —ofdel ) 

fill characters are DELs (NULS). 
cr0 cri cr2 cr3 

select style of delay for carriage returns (see fty(7)). 
nlO nl1 select style of delay for line-feeds (see fty(7)). 
tab0O tab1 tab2 tab3 

select style of delay for horizontal tabs (see tty(7). 
bs0 bs1 

select style of delay for backspaces (see fty(7)). 
ff0 ff1 select style of delay for form-feeds (see fty(7)). 
vt0 vt1 select style of delay for vertical tabs (see fty(7)). 


Local Modes 


isig (—isig ) enable (disable) the checking of characters 
against the special control characters INTR, 
QUIT, and SWTCH. 

icanon (-—icanon ) 
enable (disable) canonical input (ERASE and KILL process- 
ing). 

xcase ( —xcase ) 
canonical (unprocessed) upper/lower-case presentation. 

echo (-echo ) 
echo back (do not echo back) every character typed. 

echoe (-—echoe ) 
echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals; however, it 
does not keep track of column position and, as a result, 
may be confusing on escaped characters, tabs, and back- 
spaces. 

echok ( —echok ) 
echo (do not echo) NL after KILL character. 

Ifkc (-Ifke ) 
the same as echok ( ~echok ); obsolete. 
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echonl (-—echonl ) 
echo (do not echo) NL. ger 
nofish (—noflish ) 
disable (enable) flush after INTR, QUIT, or SWTCH. 
stwrap (-—stwrap ) . 
disable (enable) truncation of lines longer than 79 charac- 
ters on a synchronous line. 
Stflush (-—stflush ) 
enable (disable) flush on a synchronous line after every 
write (2). 
stappl (-—stappl ) 
use application mode (use line mode) on a synchronous 
line. 


Control Assignments 

control-characterc set control-character to c , where control- 
character is erase, kill, intr, quit, swtch, 
eof, eol , ctab, min, or time (ctab is used 
with i —stappl; (min and time are used with 
—icanon; see fty(7)). If c is preceded by an 
(escaped from the shell) caret (*), then the 
value used is the corresponding CTRL charac- | 
ter (e.g., ““d” is a CTRL-d); “°?” is interpreted ~ 
as DEL and “*—" is interpreted as undefined. 

line set line discipline to i (0 < i < 127). 


Combination Modes 
evenp or parity enable parenb 
| and cs/7. 

oddp_ enable parenb, cs7, and parodd. 

—parity, —evenp, or —oddp 
disable parenb, and set cs8. 

raw  _( -raw or cooked) enable (disable) raw input and output (no 
ERASE, KILL, INTR, QUIT, SWTCH, EOT, or output post pro- 
cessing). | 

nl ( —nl) 
unset (set) icrnl, onicr. In addition —nl unsets inler, igner, 
ocrnl, and onlret. 

Icase ( —Icase) 
set (unset) xcase, iucic, and olcuc. 

LCASE ( —LCASE) 
same as Icase ( —Icase). 


tabs (-tabs or tab3 ) oo 
preserve (expand to spaces) tabs when printing. . 2 
ek reset ERASE and KILL characters back to normal # and@. 
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sane ___ resets all modes to some reasonable values. 
a term set all modes suitable for the terminal type ferm , where 
— term is one of tty33, tty37, vt05, tn300, ti700, or tek. 


Miscellaneous 

flush Performs immediate flush of inout and output queues asso- 
ciated with terminal. Flush is useful when a process has 
been killed but will not terminate due to I/O pending. 

iflush Empties input queue. See flush. 

oflush Empties output queue. See flush. 

SEE ALSO 

tabs(1). 

loctl(2) in the Sys5 UNIX Programmer's Reference Manual. 

tty(7) in the UNIX User’s Reference Manual. 
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NAME 
style — analyze surface characteristics of a document 
SYNOPSIS 
lusr/plIx/style [ -—ml ] [-mm ] [ -a ] [ -e ] [ -I} num ] [ -r num 
}{-p][-—P ] file ... | | 
DESCRIPTION 
Style analyzes the surface characteristics of the writing style of a 
document. It reports on readability, sentence length and structure, 
word length and usage, verb type, and sentence openers. Because 
style runs deroff before looking at the text, formatting header files 
should be included as part of the input. The default macro package 
—ms may be overridden with the flag -mm. The flag —ml, which 
causes deroff to skip lists, should be used if the document contains 
many lists of non-sentences. The other options are used to locate 
sentences with certain characteristics. 
-a print all sentences with their length and readability index. 
—-e print all sentences that begin with an expletive. 
—p print all sentences that contain a passive verb. 
-Inum print all sentences longer than num. 
-rnum print all sentences whose readability index is greater than 
num. 
—P print parts of speech of the words in the document. 
SEE ALSO 
deroff(1) 
BUGS 
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Use of non-standard formatting macros may cause incorrect sen- 
tence breaks. 


August 29, 1986 


SU(1) UNIX Sys5 SU(1) 


NAME 
* Su — become super-user or another user 
._” SYNOPSIS 
su[-—][name[ arg... ] ] 
DESCRIPTION 


Su allows one to become another user without logging off. The 
default user name is root (i.e., Super-user). 


To use su, the appropriate password must be supplied (unless one 
is already root). If the password is correct, su will execute a new 
shell with the real and effective user ID set to that of the specified 
user. The new shell will be the optional program named in the shell 
field >f the specified user's password file entry (see passwd (4)), or 
/bin/sh if none is specified (see sh (7)). To restore normal user ID 
privileges, type an EOF (cntri-d) to the new shell. 


Any additional arguments given on the command line are passed to 
the program invoked as the shell. When using programs like sh (1), 
an arg of the form —c string executes string via the shell and an arg 
of -r will give the user a restricted shell. 


The following statements are true only if the optional program 
named in the shell field of the specified user's password file entry is 
like sh(1). lf the first argument to su is a — , the environment will be 
changed to what would be expected if the user actually logged in as 
the specified user. This is done by invoking the program used as 
the shell with an argO value whose first character is — , thus causing 
first the system's profile (/etc/profile) and then the specified user's 
profile (.profile in the new HOME directory) to be executed. Other- 
wise, the environment is passed along with the possible exception of 
$PATH , which is set to /bin:/etc:/usr/bin for root . Note that if the 
optional program used as the shell is /bin/sh , the user's .profile 
can check argO for -—sh or —Su to determine if it was invoked by 
login(1) or su(1), respectively. If the user's program is other than 
/bin/sh, then .profile is invoked with an argO of -program by both 
login(1) and su(1). | 


All attempts to become another user using su are logged in the log 
file /usr/adm/sulog . 


EXAMPLES 
To become user bin while retaining your previously exported 
environment, execute: 


su bin 


To become user bin but change the environment to what would be 
expected if bin had originally logged in, execute: 
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su - bin 
To execute command with the temporary environment and permis- \ 
sions of user bin, type: 


su - bin -c "command args” 


FILES 
/etc/passwd system's password file 
/etc/profile system's profile 
$HOME/.profile user's profile 
/usr/adm/sulog log file 

SEE ALSO | 


env(1), login(1), sh(1). 
passwd(4), profile(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 
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NAME 
sum — print checksum and block count of a file 


~ SYNOPSIS 


sum [ —-r | file 


DESCRIPTION | 
Sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of blocks in the file. It is typically used to 
look for bad spots, or to validate a file communicated over some 
transmission line. The option —r causes an alternate algorithm to be 
used in computing the checksum. 


SEE ALSO 
wc(1). 


DIAGNOSTICS 
“Read error’ is indistinguishable from end of file on most devices; 
check the block count. 
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NAME 
sync — update the super block 


SYNOPSIS 
sync 


DESCRIPTION 
Sync executes the sync system primitive. If the system is to be 
stopped, sync must be called to insure file system integrity. It will 
flush all previously unwritten system buffers out to disk, thus assur- 
ing that all file modifications up to that point will be saved. See sync 
(2) for details. 


SEE ALSO 
sync(2) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
tabs — set tabs on a terminal 


SYNOPSIS 
tabs [ tabspec ][ +m n ][ —T type ] 


DESCRIPTION | 
Tabs sets the tab stops on the user’s terminal according to the tab 
specification tabspec , after clearing any previous settings. The 
user's terminal must have remotely-settable hardware tabs. 


Users of GE TermiNet terminals should be aware that they behave 
in a different way than most other terminals for some tab settings. 
The first number in a list of tab settings becomes the /eft margin on 
a TermiNet terminal. Thus, any list of tab numbers whose first ele- 
ment is other than 1 causes a margin to be left on a TermiNet, but 
not on other terminals. A tab list beginning with 1 causes the same 
effect regardless of terminal type. It is possible to set a left margin 
on some other terminals, although in a different way (see below). 


Four types of tab specification are accepted for tabspec : “canned,” 
repetitive, arbitrary, and file. If no tabspec is given, the default 
value is -8 , i.e., UNIX system “standard” tabs. The lowest column 
number is 1. Note that for tabs , column 1 always refers to the left- 
most column on a terminal, even one whose column markers begin 
at 0, e.g., the DAS! 300, DAS! 300s, and DAS! 450. 


—code Gives the name of one of a set of “canned” tabs. The 
legal codes and their meanings are as follows: 
—a 1,10,16,36,72 
Assembler, IBM S/370, first format 
—a2 1,10,16,40,72 
Assembler, IBM S/370, second format 
—C 1,8,12,16,20,55 
COBOL, normal format 
—C2 1,6,10,14,49 
COBOL compact format (columns 1-6 omitted). Using this 
code, the first typed character corresponds to card column 
7, One space gets you to column 8, and a tab reaches 
column 12. Files using this tab setup should include a for- 
mat specification as follows: 
<:t-c2 m6 s66 d:> 
—C3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 
COBOL compact format (columns 1-6 omitted), with more 
tabs than —c2. This is the recommended format for COBOL. 
| The appropriate format specification is: 
- <:t-c3 m6 s66 d:> 
—f 1,7,11,15,19,23 
FORTRAN 
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1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 
PL/I 7 

1,10,55 

SNOBOL 

1,12,20,44 

UNIVAC 1100 Assembler 


In addition to these “canned” formats, three other types exist: 


—f) 


A repetitive specification requests tabs at columns 1+n, 
1+2«n, etc. Note that such a setting leaves a left margin 
of n columns on TermiNet terminals only . Of particular 
importance is the value —8 : this represents the UNIX sys- 
tem “standard” tab setting, and is the most likely tab set- 
ting to be found at a terminal. It is required for use with the 
nroff -—h option for high-speed output. Another special 
case is the value —0 , implying no tabs at all. 


AT ene: i 


—file 


The arbitrary format permits the user to type any chosen 
set of numbers, separated by commas, in ascending order. 
Up to 40 numbers are allowed. If any number (except the 
first one) is preceded by a plus sign, it is taken as an incre- 
ment to be added to the previous value. Thus, the tab lists 
1,10,20,30 and 1,10,+10,+10 are considered identical. 

If the name of a file is given, tabs reads the first line of the 
file, searching for a format specification. If it finds one 
there, it sets the tab stops according to it, otherwise it sets 
them as -8 . This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set- 
tings, and would be used with the pr (7) command: 

| tabs — file; pr file 


Any of the following may be used also; if a given flag occurs more 
than once, the last value given takes effect: 


-—Ttype 


Tabs usually needs to know the type of terminal in order to 
set tabs and always needs to know the type to set mar- 
gins. Type is a name listed in term (5). If no —T flag is 
supplied, tabs searches for the $TERM value in the 


environment (see environ (5)). If no type can be found, 


+mn 
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tabs tries a sequence that will work for many terminals. 
The margin argument can be used for some terminals. It 
causes all tabs to be moved n columns by making column 
n+7 the left margin. If +m is given without a value of n, 
the value assumed is 10. For a TermiNet, the first value in 
the tab list must be 1, or the margin will move further to the 
right. The normal (leftmost) margin on most terminals is 
obtained by +mQ . The margin for most terminals is reset 
only when the +m flag is given explicitly. 
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Tab and margin setting is performed via the standard output. 


( ~ DIAGNOSTICS 


illegal tabs when arbitrary tabs are ordered incorrectly. 

illegal increment when a zero or missing increment is found in 
an arbitrary specification. 

unknown tab code’ when a “canned” code cannot be found. 

can't open if —file option used, and file can't be opened. 

file indirection if —file option used and the specification in 
that file points to yet another file. Indirection 
of this form is not permitted. 


SEE ALSO 


BUGS 
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pr(1). 
environ(5), term(5) in the Sys5 UNIX Programmer Reference 
Manual. 


There is no consistency among different terminals regarding ways of 
Clearing tabs and setting the left margin. 

It is generally impossible to usefully change the left margin without 
also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), 
but is willing to set 64. 
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NAME 
tail — deliver the last part of a file 


_." SYNOPSIS 
tail [ + [number][ Ibc [ f ] ] ] [ file ] 


DESCRIPTION | 
Tail copies the named file to the standard output beginning at a 
designated place. If no file is named, the standard input is used. 


Copying begins at distance +number from the beginning, or 
—number from the end of the input (if number is null, the value 10 is 
assumed). Number is counted in units of lines, blocks, or charac- 
ters, according to the appended option |, b , or ¢ . When no units 
are specified, counting is by lines. 


With the -f (“follow”) option, if the input file is not a pipe, the pro- 
gram will not terminate after the line of the input file has been 
copied, but will enter an endless loop, wherein it sleeps for a second 
and then attempts to read and copy further records from the input 
file. Thus it may be used to monitor the growth of a file that is being 
written by some other process. For example, the command: 


tail -f fred 
= will print the last ten lines of the file fred , followed by any lines that 
q> are appended to fred between the time fai! is initiated and killed. 


As another example, the command: 
tail —15cf fred 


will print the last 15 characters of the file fred , followed by any lines 
that are appended to fred between the time fai! is initiated and 
killed. 


SEE ALSO 
dd(1). 

BUGS 
Tails relative to the end of the file are treasured up in a buffer, and 
thus are limited in length. Various kinds of anomalous behavior may 
happen with character special files. 
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NAME 
tape - tape manipulation 
SYNOPSIS 
tape [ -9ctf [filename] ] [command [options] ] 
DESCRIPTION 
Tape executes special commands on 9-track and cartridge tapes. 
Tape accesses the filename given via the -f switch. If none is given, 
the program opens the tape filename, /dev/nrrmhO. If that fails, it 
opens /dev/nrmt0O. The tape file it eventually accesses must be a 
character special file. 
Tape figures out the type of tape (9-track or cartridge) unless the 'c’ 
or '9’ switches are given. 
The available switches are: 
Cc The tape file is on a cartridge tape. Tape does not try 
figure out the type of tape if this is given. 
9 The tape file is on a 9-track tape. Tape does not try 
figure out the type of tape if this is given. 
t | Print the type of tape. 
f filename Do the special command on the tape file filename. 
Filename must be a character special file. 
Tape accepts a command after the switches. If none is given, it 
assumes the command status for the 9-track and srcheof O for the 
cartridge. 
These are the acceptable commands and their options for a 9-track 
tape: 
erase Erases a fixed length (approximately 3.5 inches) for 
each value of n from the current position. 
eraseall Erase tape from current position to beyond the end of 
tape. | 
status Report the status returned by tape controller. 
rforeign Reports the status and block size in bytes of file on 
tape. Leaves the tape in the middle of the file. 
unload Unloads the tape. 
space n Space forward n data blocks. 
spaceeof 7 Space forward n data blocks. Terminates early if it 
encounters an end-of-file on tape. 
srcheof n Position tape to the n-th end-of-file mark from the 
current position. If n is omitted, 1 is assumed. n 
should be a positive integer. If filename is given with 
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rew 
weof 
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the f switch you should specify a tape filename with 
no rewind, e.g., /dev/rrm/Omn. 


Rewinds the tape to the load point. 


Write an end-of-file on tape at current position. 


These are the acceptable commands and their options for a car- 


tridge tape: 
rew 
weof 


srcheof n 


eraseall 
retension 


Rewinds the cartridge to the load point. 


Write an end-of-file on cartridge at current position. 
This is dangerous because it could overwrite data 
anywhere on the cartridge. Don't use it if you want 
the data on the cartridge. 


Position to the n-th file on the cartridge. Positioning 
is always done from the beginning of the cartridge. If 
n is omitted, 1 is assumed. n should be a positive 
integer. If filename is given with the f switch you 
should specify a tape filename with no rewind, e.g., 
/dev/nrmto. 


Erase cartridge. The abbreviation ‘erase’ works also. 


Retension the cartridge. This should be done with 
new cartridges, cartridges that have been unused for 
some time, or cartridges that produce a hard error 
when accessing. The abbreviation ‘ret’ works also. 
See the Plexus Cartridge Tape Drive Manual (Plexus 
Publication Number 5016) for more information. 


The filename /dev/nrrmh0 is a special device for a 9-track tape. It 
allows tape to do certain commands in streaming mode, e.g., 
srcheof. See rm(4). 


FILES 


/dev/rrm/Omn | 


/dev/rpt/Om 


SEE ALSO 
pt(7), rm(7). 
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NAME 


tar — tape file archiver 


SYNOPSIS 


tar [ key ] [ files ] 


DESCRIPTION 
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Tar saves and restores files on magnetic tape. Its actions are con- 
trolled by the key argument. The key is a string of characters con- 
taining at most one function letter and possibly one or more function 
modifiers. Other arguments to the command are files (or directory 
names) specifying which files are to be dumped or restored. In all 
cases, appearance of a directory name refers to the files and (recur- 
sively) subdirectories of that directory. 


The function portion of the key is specified by one of the following 
letters: 


r The named files are written on the end of the tape. Thec 
function implies this function. 


x The named files are extracted from the tape. If a named file 
matches a directory whose contents had been written onto 
the tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no 
files argument is given, the entire content of the tape is 
extracted. Note that if several files with the same name are 
on the tape, the last one overwrites all earlier ones. 


t The names of the specified files are listed each time that they 
| occur on the tape. If no files argument is given, all the 
names on the tape are listed. 


u The named files are added to the tape if they are not already 
there, or have been modified since last written on that tape. 


c Create a new tape; writing begins at the beginning of the 
tape, instead of after the last file. This command implies the 
r function. 


The following characters may be used in addition to the letter that 
selects the desired function: 


0,...,7 This modifier selects the drive on which the tape is mounted. 
The default is 0. 


Vv Normally, tar does its work silently. The v (verbose) option 
causes it to type the name of each file it treats, preceded by 
the function letter. With the t function, v gives more informa- 
tion about the tape entries than just the name. 


w Causes tar to print the action to be taken, followed by the 
name of the file, and then wait for the user’s confirmation. lf 
a word beginning with y is given, the action is performed. 
Any other input means “‘no’’. 
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FILES 


f Causes tar to use the next argument as the name of the 
archive instead of /dev/rrm0. If the name of the file is —, tar 
writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as 
the head or tail of a pipeline. Tar can also be used to move 
hierarchies with the command: 


(cd fromdir; tar cf —.) | (cd todir; tar xf —) 


b Causes tar to use the next argument as the blocking factor 
for tape records. The default is 1, the maximum is 20. The 
block size is determined automatically when reading tapes 
(key letters x and t). Specifying the wrong block size with the 
b option can lead to unpredictable results. 


l Tells tar to complain if it cannot resolve all of the links to the 
files being dumped. If I is not specified, no error messages 
are printed. 


m Tells tar to not restore the modification times. The 
modification time of the file will be the time of extraction. 


/dev/rpt/Om (cartridge tape - rewind) 
/dev/rpt/Omn_ (cartridge tape - no rewind) 
/dev/rrm/Om_ (9-track tape - rewind) 
/dev/rrm/Omn (9-track tape - no rewind) 
/tmp/tars 


DIAGNOSTICS 


BUGS 


Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 


There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be 
updated. The current magnetic tape driver cannot backspace raw 
magnetic tape. If the archive is on a disk file, the b option should not 
be used at all, because updating an archive stored on disk can des- 
troy it. 

The current limit on file-name length is 100 characters. 

The r and u options do not work. 

Tar does not preserve the access modes and ownership of direc- — 
tories. If you need them preserved, use cp/o(1) instead. See also 
find(1). 
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NAME 
tb| — format tables for nroff or troff 


| + SYNOPSIS 
tbl [ -TX ] [ files ] 


DESCRIPTION 
Tbi is a preprocessor that formats tables for nroff or troff(1). The 
input files are copied to the standard output, except for lines 
between .TS and .TE command lines, which are assumed to 
describe tables and are re-formatted by fb/. (The .TS and .TE com- 
mand lines are not altered by fbi). 


.TS is followed by global options. The available global options are: 


center center the table (default is left-adjust); 

expand make the table as wide as the current line 
length; 

box enclose the table in a box; 

doublebox 
enclose the table in a double box; 

allbox enclose each item of the table in a box; 

tab (x) use the character x instead of a tab to separate 
items in a line of input data. 


C The global options, if any, are terminated with a semi-colon (;). 


a Next come lines describing the format of each line of the table. 
Each such format line describes one line of the actual table, except 
that the last format line (which must end with a period) describes all 
remaining lines of the table. Each column of each line of the table 
is described by a single key-letter, optionally followed by specifiers 
that determine the font and point size of the corresponding item, 
that indicate where vertical bars are to appear between columns, 
that determine column width, inter-column spacing, etc. The avail- 
able key-letters are: 


Cc center item within the column; 

r right-adjust item within the column; 

| left-adjust item within the column; 

n numerically adjust item in the column: units posi- 


tions of numbers are aligned vertically; 

span previous item on the left into this column; 

a center longest line in this column and then left- 
adjust all other lines in this column with respect to 
that centered line; 

span down previous entry in this column; 

replace this entry with a horizontal line; 

replace this entry with a double horizontal line. 


” 
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The characters B and | stand for the bold and italic fonts, respec- 
tively; the character | indicates a vertical line between columns. oo 


The format lines are followed by lines containing the actual data for _ 
the table, followed finally by .TE Within such data lines, data items 
are normally separated by tab characters. , 


lf a data line consists of only _ or =, a single or double line, respec- 
tively, is drawn across the table at that point; if a single item ina 
data line consists of only _ or =, then that item is replaced by a sin- 
gle or doubie line. 


Full details of all these and other features of tb/ are given in the 
reference manual cited below. 


The -TX option forces tb/ to use only full vertical line motions, mak- 
ing the output more suitable for devices that cannot generate partial 
vertical line motions (e.g., line printers). 


If no file names are given as arguments (or if — is specified as the 
last argument), fb/ reads the standard input, so it may be used as a 
filter. When it is used with eqn(1) or neqn, tb! should come first to 
minimize the volume of data passed through pipes. 


EXAMPLE 
If we let - represent a tab (which should be typed as a genuine tab), ~~ 
then the input: | 


an 


Se 


TS 

center box ; 

cB ss 

cl | cls 

= ee 

lJnn. 

Household Population 


Town-Households 
+Number-Size 
Bedminster--789-3.26 
Bernards Twp.-3087-3.74 
Bernardsville-2018-3.30 
Bound Brook-3425-3.04 — 
Bridgewater-7897-3.81 
Far Hills-240-3.19 

slE 


yields: a 


September 18, 1986 Page 2 


( 


TBL (1) UNIX Sys5 TBL(1) 


Household Population 


Households 
Number Size 


789 


Bedminster 

Bernards Twp. 3087 
Bernardsville — 2018 
Bound Brook 3425 
Bridgewater 7897 
Far Hills | 240 


SEE ALSO 
ocw(1), eqn(1), mm(1), mmt(1), nroff(1), troff(1), mm(5), mv(5). 


BUGS 
See BUGS under nroff(1). 
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tc, otc — troff output interpreter 


SYNOPSIS 


tc [ -t ] [ -olist ] [ -an ] [ -e ] [ file ] 
otc [ -t ] [ -sn ] [ -pl ] [ file ] 


DESCRIPTION 
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Tc interprets its input (standard input default) as output from troff(1). 
The standard output of fc is intended for a TEKTRONIX 4015 (a 4014 
terminal with ASCII and APL character sets). The various typesetter 
sizes are mapped into the 4014's four sizes; the entire TROFF char- 
acter set is drawn using the 4014's character generator, using over- 
struck combinations where necessary, producing an altogether 
displeasing effect. Ofc performs a similar function for the old 
TROFF, otroff (see nroff(1)). Typical usage: 


troff file | tc 
otroff -t file | otc 


At the end of each page tc waits for a new-line (empty line) from the 
keyboard before continuing on to the next page. In this wait state, 
the following commands are recognized: 


Icmd Send cmd to the shell. 


e Invert state of the screen erase (tc); do not erase screen > 


before next page (otc). 
—n Skip backward n pages. (tc only). 


n Print page n. (tc only). 

sn Skip forward n pages. (ofc only). 

an Set the aspect ratio ton. (fc only). 

? Print list of available options. (fc only). 


The command line options are: 
—t Do not wait between pages (for directing output into a file). 


—Olist Prints only the pages enumerated in list. The list consists 
of pages and page ranges (e.g., 5-17) separated by com- 
mas. The range n— goes from n to the end; the range —n 
goes from the beginning to and including page n. (fc only). 


—an Set the aspect ratio to n; default is 1.5. (tc only). 
~@ Do not erase before each page. (tc only). 
-sn Skip the first m pages. (ofc only). 
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—p/ Set page length to /; / may include the scale factors p 
(points), i (inches), c (centimeters), and P (picas); Default is 
picas. (otc only). 


SEE ALSO 
4014(1), nroff(1), tplot(1G), troff(1). 


BUGS 
Font distinctions are lost. 
It needs a —w option to wait for input to arrive. 


i \ 
‘ A 
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f NAME 
' tee — pipe fitting 


SYNOPSIS 
tee [ -i | [ -a ] [ file ] ... 


DESCRIPTION : 
Tee transcribes the standard input to the standard output and 
makes copies in the files . The —i option ignores interrupts; the —a 
option causes the output to be appended to the files rather than 
overwriting them. , 
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test — condition evaluation command 
SYNOPSIS 


test expr 
[ expr ] 
DESCRIPTION 


Test evaluates the expression expr and, if its value is true, returns 
a zero (true) exit status; otherwise, a non-zero (false) exit status is 
returned; test also returns a non-zero exit status if there are no 
arguments. The following primitives are used to construct expr : 


—r file 
~—w file 
—x file 
-f file 
—d file 
—C file 


—b file 


—p file 
—u file 
~g file 
—k file 
-S file 


—t [ fildes | 


—Z s1 
—n si 


sft = s2 
s? != s2 


S17 


nt —eq n2 


true if file exists and is readable. 

true if file exists and is writable. 

true if file exists and is executable. 

true if file exists and is a regular file. 

true if file exists and is a directory. 

true if file exists and is a character special file. 
true if file exists and is a block special file. 
true if file exists and is a named pipe (fifo). 
true if file exists and its set-user-ID bit is set. 
true if file exists and its set-group-ID bit is set. 
true if file exists and its sticky bit is set. 

true if file exists and has a size greater than zero. 


true if the open file whose file descriptor number is 
fildes (1 by default) is associated with a terminal dev- 
ice. 


true if the length of string s7 is zero. 

true if the length of the string s7 is non-zero. 
true if strings s7 and s2 are identical. 

true if strings s7? and s2 are not identical. 
true if s7 is not the null string. 


true if the integers n7 and n2 are algebraically equal. 
Any of the comparisons —ne , —gt , -ge , —It , and —le 
may be used in place of -eq. 
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These primaries may be combined with the following 


( ; operators: 


! unary negation operator. 
—a binary and operator. 
—O binary or operator (—a has higher precedence than —o 


| ). | 
( expr ) parentheses for grouping. 


Notice that all the operators and flags are separate arguments to 
test . Notice also that parentheses are meaningful to the shell and, 
therefore, must be escaped. 


SEE ALSO 
find(1), sh(1). 

WARNING 
In the second form of the command (i.e., the one that uses [] , 
rather than the word test ), the square brackets must be delimited 
by blanks. | 
Some UNIX systems do not recognize the second form of the com- 
mand. | 
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NAME _ «| | 7 a 


time — time a command . 
SYNOPSIS | 

time command 
DESCRIPTION | 


The command is executed; after it is complete, fime prints the 
elapsed time during the command, the time spent in the system, 
and the time spent in execution of the command. Times are 
~ reported in seconds. i 

The times are printed on standard error. 


SEE ALSO 
timex(1). 
times(2) in the Sys5 UNIX Programmer Reference Manual. 
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~ NAME 
: ( timex — time a command; report process data and system activity 


SYNOPSIS 
timex [options] command 


DESCRIPTION , 
The given command is executed; the elapsed time, user time and 
system time spent in execution are reported in seconds. Optionally, 
process accounting data for the command and all its children can 
be listed or summarized, and total system activity during the execu- 
tion interval can be reported. 


The output of timex is written on standard error. 
Options are: 


-p __ List process accounting records for command and all its chil- 
dren. Suboptions f, h, k, m, r, and t modify the data items 
reported, as defined in acctcom (71). The number of blocks 
read or written and the number of characters transferred are 
always reported. 


-O Report the total number of blocks read or written and total 
Cc characters transferred by command and all its children. 


kw - =—§ Report total system activity (not just that due to command ) 
| | that occurred during the execution interval of command . All 
the data items listed in sar (7) are reported. 


SEE ALSO 
acctcom(1), sar(1). 


WARNING 
Process records associated with command are selected from the 
accounting file /usr’adm‘pacct by inference, since process geneal- 
ogy is not available. Background processes having the same user- 
id, terminal-id, and execution time window will be spuriously 
included. 


EXAMPLES 
A simple example: 


timex —ops sleep 60 


A terminal session of arbitrary complexity can be measured by tim- 
ing a sub-shell: 


timex —opskmt sh 


} session commands 
: EOT 


Page 1 | | May 29, 1985 


TOC(1G) 


NAME 


Page 1 


UNIX Sys5 TOC(1G) 


toc — graphical table of contents routines 


SYNOPSIS 
dtoc [directory] 

ttoc mm-file 

vtoc [—cdhnimsvn] [TTOC file] 


DESCRIPTION 
All of the commands listed below reside in /usr/bin/graf (see graph- 


ics (1G)). 
dtoc 


ttoc 


vtoc 


Dtoc makes a textual table of contents, TTOC, of all sub- 
directories beginning at directory (directory defaults to .). 
The list has one entry per directory. The entry fields 
from left to right are level number, directory name, and 
the number of ordinary readable files in the directory. 
Dtoc is useful in making a visual display of all or parts of 
a file system. The following will make a visual display of 
all the readable directories under /: 
dtoc / | vtoc | td 


Output is the table of contents generated by the TC 


macro of mm(1) translated to TTOC format. The input is ~— 
assumed to be an mm file that uses the .H family of ~ 


macros for section headers. If no file is given, the stan- 
dard input is assumed. 


Vtoc produces a GPS describing a hierarchy chart from a 
TTOC. The output drawing consists of boxes containing 
text connected in a tree structure. If no file is given, the 
standard input is assumed. Each TTOC entry describes 


one box and has the form: id [line-weight,line- 
Style] "text" [mark] 

where: — 

id is an alternating sequence of numbers and 


dots. The fd specifies the position of the 
entry in the hierarchy. The id Q. is the root 
of the tree. 
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line-weight 1s either: 


n, normal-weight; or 
‘m, medium-weight; or 
b, bold-weight. 


line-style is either: — 


text 


mark 


so, solid-line; 

do, dotted-line; 
dd, dot-dash line; 
da, dashed-line; or 
Id, long-dashed 


is a character string surrounded by quotes. 
The characters between the quotes © 
become the contents of the box. To 
include a quote within a box it must be 
escaped (\"). 


is a character string (Surrounded by quotes 
if it contains spaces), with included dots 
being escaped. The string is put above the 
top right corner of the box. To include 
either a quote or a dot within a mark it 
must be escaped. 


Entry example: 1.1 b,da “ABC” DEF 
Entries may span more than one line by escaping the 
new-line (\new-line). 


Comments are surrounded by the /*,*/ pair. They may 
appear anywhere in a TTOC. 


Options: 


Cc 
d 
hn 


vn 


Use text as entered (default is all upper case). 
Connect the boxes with diagonal lines. 
Horizontal interbox space is 1% of box width. 
Suppress the box jd. 

Suppress the box mark. 

Do not compact boxes horizontally. 

Vertical interbox space is N% of box height. 
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SEE ALSO 
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graphics(1G). — | 
gps(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 

touch — update access and modification times of a file 
SYNOPSIS 

touch [ -amc ] [ mmddhhmm [yy] ] files 
DESCRIPTION . 


Touch causes the access and modification times of each argument 
to be updated. The file name is created if it does not exist. If no 
time is specified (see date (1)) the current time is used. The -a 
and —m options cause touch to update only the access or modifica- 
tion times respectively (default is -am ). The -—c option silently 
prevents touch from creating the file if it did not previously exist. 


The return code from touch is the number of files for which the 
times could not be successfully modified (including files that did not 
exist and were not created). 

SEE ALSO — 
date(1). ; 
utime(2) in the UNIX System Programmer Reference Manual. 
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NAME a 
tplot — graphics filters | Ny 
SYNOPSIS 
tplot [ -T terminal [ -e raster | |] 
DESCRIPTION 


These commands read plotting instructions (see plot (4)) from the 
standard input and in general produce, on the standard output, plot- 
ting instructions suitable for a particular terminal . If no terminal is 
specified, the environment parameter $TERM (see environ (5)) is 
used. Known terminal s are: 


300 DAS! 300. 

300S DAS! 300s. 

450 _ DAS! 450. 

4014 TEKTRONIX 4014. 

ver Versatec D1200A. This version of plot places a scan- 
converted image in /usr/tmp/raster $$ and sends the result 
directly to the plotter device, rather than to the standard out- 
put. The -—e option causes a previously scan-converted file 
raster to be sent to the plotter. 


FILES -~ 
/usr/lib/t300 : 
/usr/lib/t300s 
/usr/lib/t450 
/usr/lib/t4014 
/usr/lib/vplot 
/usr/tmp/raster$$ 


SEE ALSO : | 
plot(3X), plot(4), term(5) in the Sys5 UNIX Programmer Reference 
Manual. | 
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NAME 


tput — query terminfo database 


SYNOPSIS 


tput [ -T type ] capname 


DESCRIPTION : 


Tput uses the terminfo(4) database to make terminal-dependent 
capabilities and information available to the shell. Tput outputs a 
string if the attribute (capability name) is of type string, or an integer 
if the attribute is of type integer. If the attribute is of type boolean, 
tput simply sets the exit code (0 for TRUE, 1 for FALSE), and does 
no output. 


-Ttype indicates the type of terminal. Normally this flag is 
unnecessary, as the default is taken from the environ- 
ment variable $TERM. 

Capname indicates the attribute from the terminfo database. See 
terminfo(4 ). 


EXAMPLES 


FILES 


tput clear | Echo clear-screen sequence for the current ter- 
minal. 

tput cols Print the number of columns for the current ter- 
minal. 

tput -T450 cols Print the number of columns for the 450 termi- 
nal. 

bold =‘tput smso‘ Set shell variable "bold" to stand-out mode 
sequence for current terminal. This might be 
followed by a prompt: 
echo "${bold}Please type in your name: \c" 

tput hc Set exit code to indicate if current terminal is a 
hardcopy terminal. 


/etc/term/?/* Terminal descriptor files 
/usr/include/term.h Definition files 
/usr/include/curses.h 


DIAGNOSTICS 
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Tput prints error messages and returns the following error codes on 
error: 


-1 Usage error. 
-2 Bad terminal type. 
-3 Bad capname. 


In addition, if a capname is requested for a terminal that has no 
value for that capname (e.g., tput -T450 lines ), -1 is printed. 
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SEE ALSO 
stty(1). | | = 
terminfo(4) in the Sys5 UNIX Programmer Reference Manual. 
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_ NAME 
( 3 tr — translate characters 
—"_ SYNOPSIS 
tr [ —cds ] [ string1 [ string2 ] ] 
DESCRIPTION 


Tr copies the standard input to the standard output with substitution 
or deletion of selected characters. Input characters found in string? 
are mapped into the corresponding characters of string2 . Any com- 
bination of the options —cds may be used: 


—C Complements the set of characters in string? with respect 
to the universe of characters whose ASCII codes are 001 
through 377 octal. 


—d Deletes all-input characters in string? . 


-s Squeezes all strings of repeated output characters that are 
in string2 to single characters. 


The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 


[a-z] Stands for the string of characters whose ASCII codes run 
Cc from character a to character z , inclusive. 


' ) [axn] Stands for n repetitions of a. If the first digit of n is 0,7 is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding string2 . 


The escape character \ may be used as in the shell to remove spe- 
cial meaning from any character in a string. In addition, \ followed 
by 1, 2, or 3 octal digits stands for the character whose ASCII code 
is given by those digits. 


The following example creates a list of all the words in file7 one per 
line in file2, where a word is taken to be a maximal string of alpha- 
betics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline. 


tr —cs "[A—Z][a-z]" "[\012*]" <file1 >file2 
SEE ALSO | 
ed(1), sh(1). 
ascii(5) in the Sys5 UNIX Programmer Reference Manual. 
BUGS 


a Will not handle ASCII NUL in string? or string2 ; always deletes NUL 
} from input. 
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NAME 

troff — text formatting and typesetting 
SYNOPSIS 

troff [ option ] .... [ file ] ... 
DESCRIPTION 

Troff formats text in the named files for printing on a photo- 

typesetter. It is the new "device-independent” version of the old ofr- 

off (see nroff(1)). Its capabilities are described in the NROFF/TROFF 

User Manual plus the Addendum. 

If no file argument is present, the standard input is read. An argu- 

ment consisting of a single minus (—) is taken to be a file name 

corresponding to the standard input. The options, which may 
appear in any order so long as they appear before the files, are: 

-Olist Print only pages whose page numbers appear in the 
comma-separated /ist of numbers and ranges. A range 
N—-M means pages N through M; an initial -N means from 
the beginning to page N; and a final N— means from N to 
the end. (See BUGS below.) 

—nN Number first generated page N. 

—SN Generate output to encourage typesetter to stop every N 
pages. 

—mname Prepend the macro file /usr/lib/tmac/tmac.name to the 
input files. 

—raN Set register a (one character name) to N. 

—| Read standard input after the input files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd 
request. | | 

-Z Print only messages generated by .tm requests. 

-a Send a printable ASCII approximation of the results to the 
standard output. 

-Tdest Prepare output for typesetter dest. Currently the only sup- 
ported typesetter is the Autologic APS-5, (-Taps). Users 
of the Wang CAT should use otroff (see nroff(1)). Sup- 
ported laser printers are the Imagen Imprint -10 (—T/70) 
and the Xerox 9700 (see dx9700(1)). 

FILES 

/tmp/trtmp* temporary file 

/usr/lib/tmac/ftmac.* standard macro files 

/usr/lib/macros/* standard macro files 

/usr/lib/font/dev*/* — font width tables 
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_ SEE ALSO 
( dx9700(1), eqn(1), mmt(1), nroff(1), pic(1), tbi(1), te(1). 
= NROFF/TROFF User Manual with Addendum on the device- 
independent TROFF and A TROFF Tutorial . 


BUGS 
The .tlh request may not be used before the first break-producing 
request in the input to troff. 


Troff believes in Eastern Standard Time; as a result, depending on 
the time of the year and on your local time zone, the date that troff 
generates may be off by one day from your idea of what the date is. 


When troff is used with the —olist option inside a pipeline (e.g., with 
one or more of pic(1), eqn(1), and tb/(1)), it may cause a harmless 
“broken pipe’ diagnostic if the last page of the document is not 
specified in /ist. a 
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NAME 
true, false — provide truth values 
SYNOPSIS a | 
true 
false | | 
DESCRIPTION | : po 
_ True does nothing, successfully. False does nothing, unsuccess- 
— fully. They are typically used in input to sh (1) such as: 
while true 
do | 
| command 
done 
SEE ALSO 
sh(1). 
DIAGNOSTICS 


True has exit status zero, false nonzero. 
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-. NAME 


tset — set terminal modes | 


SYNOPSIS 


/usr/plx/tset [ — ] [ -—hrs!QS ] [ -e[c] ] [ -Efc] ] 
[ -—k[c] ] [ —m [/dent][test baudrate]:type ] [ type |] 


DESCRIPTION 
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Tset causes terminal dependent processing such as setting erase 
and kill characters, setting or resetting delays, and the like. It is 
driven by the /etc/ttytype and /etc/termcap files. 


The type argument specifies the type of terminal. The type may be 
any type given in /etc/termcap. If type is not specified, the terminal 
type is read from the environment TERM, unless the —h flag is set 
or any —m argument was given. In this case the type is read from 
/etc/ttytype (the data base that links port names to terminal types). 
The port name is determined by a ttyname(3) call on the diagnostic 
output. If the port is not found in /etc/ttytype, the terminal type is 
set to unknown. 


Ports for which the terminal type is indeterminate are identified in 
/etc/ttytype as dialup, plugboard, etc. You can specify how these 
identifiers should map to an actual terminal type. The mapping flag, 
—m, is followed by the appropriate identifier (a 4 character or longer 
substring is adequate), an optional test for baud rate, and the termi- 
nal type to be used if the mapping conditions are satisfied. If more 
than one mapping is specified, the first correct mapping prevails. A 
missing identifier matches all identifiers. Baud rates are specified 
as with sfty(1), and are compared with the speed of the diagnostic 
output. The test may be any combination of: >, =, <, @, and !. 
(Note: @ is a synonym for = and ! inverts the sense of the test. 
Remember to escape characters meaningful to the shell.) 


If the type as determined above begins with a question mark, ftset 
asks if you really want that type. A null response means to use that 
type; otherwise, another type can be entered, which is then used 
instead. (The question mark must be escaped to prevent filename 
expansion by the shell.) 


On terminals that can backspace but not overstrike (such as a CAT), 
and when the erase character is the default erase character (‘#’ on 
standard systems), the erase character is changed to a Control-H 
(backspace). The ~e flag sets the erase character to be the named 
character c on all terminals, so to override this option you can say 
-—e#. The default for c is the backspace character on the terminal, 
usually Control-H. The —E flag is identical to -e except that it only 
operates on terminals that can backspace; it might be used with an 
ASR33. The —k option works similarly, with c defaulting to Control- 
X. No kill processing is done if —k is not specified. In ail of these 
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flags, ““X’, where X is any character, is equivalent to control-X. en 


The — option prints the terminal type on the standard output; this \ 
can be used to get the terminal type by saying: 


set termtype = ‘tset - 


If no other options are given, tset operates in “fast mode” and only 
outputs the terminal type, bypassing all other processing. 


The -—sS outputs export and assignment commands (if your default 
shell is the Bourne shell). Use: 


tset -s ... > Amp/tset$$ 
/tmp/tset$$ 
rm /tmp/tset$$ 


For the same effect, if you are using csh, use: 


set noglob 

set term=(‘tset -S ....') 
setenv TERM $term[1] 
setenv TERMCAP "$term[2]" = 
unset term 
unset noglob 


The —S option only outputs the strings to be placed in the environ- 
ment variables. 


The —r option prints the terminal type on the diagnostic output. 


The —Q option supresses printing the “Erase set to” and “Kill set to” 
messages. 


The —I option supresses outputing the terminal initialization strings. 


Tset is most useful when included in the .login (for csh(1)) or .pro- 
file (for sh(1)) file executed automatically at login, with —-m mapping 
used to specify the terminal type you most frequently dial in on. 


EXAMPLES 

tset gt42 

tset —mdialup\>300:adm3a —mdialup:dw2 —Qr -e# 

tset —m dial:ti733 —m plug:\?hp2621 —m unknown:\? —e —kK°U 
FILES | 


/etc/ttytype Port name to terminal type map database 
fetcittermcap ‘Terminal capability database a 


NOTES : 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


/ 
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SEE ALSO 
csh(1), stty(1). 
termcap(5), ttytype(5) in the Sys5 UNIX Programmer’s Reference 
Manual. | 


NOTES | 
For compatibility with earlier versions of tset, the following flags are 
accepted and mapped internally as shown: | 


-dtype -> -mdialup:type 
-ptype -> -m plugboard:type 
-atype -> -m arpanet:type 


These flags will disappear eventually. 
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NAME 

tsort — topological sort 

SYNOPSIS oe 
tsort [ file | 

DESCRIPTION 
Tsort produces on the standard output a totally ordered list of items 
consistent with a partial ordering of items mentioned in the input file 
. If no file is specified, the standard input is understood. 
The input consists of pairs of items (nonempty strings) separated by 
blanks. Pairs of different items indicate ordering. Pairs of identical 
items indicate presence, but not ordering. 


SEE ALSO 
lorder(1). 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 


BUGS 
Uses a quadratic algorithm; not worth fixing for the typical use of 
ordering a library archive file. 
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~ NAME 


tty — get the name of the terminal 


SYNOPSIS 
tty[-l][-s] 

DESCRIPTION 2 
Tty prints the path name of the user's terminal. The -I option prints 
the synchronous line number to which the user’s terminal is con- 
nected, if it is on an active synchronous line. The —s option inhibits 
printing of the terminal path name, allowing one to test just the exit 


code. 
EXIT CODES 
2 if invalid options were specified, 
0 if standard input is a terminal, 
1 otherwise. 
DIAGNOSTICS 
“not a tty” if the standard input is not a terminal and —s is not speci- 
fied. 


Page 1 May 27, 1985 


UMASK(1) UNIX Sys5 UMASK(1) 


NAME 
umask — set file-creation mode mask 


SYNOPSIS 
umask [ 000 | 


DESCRIPTION 

: The user file-creation mode mask is set to ooo . The three octal 
digits refer to read:write;execute permissions for Owner , group , 
and others , respectively (see chmod (2) and umask (2)). The value 
of each specified digit is subtracted from the corresponding ‘digit’ 
specified by the system for the creation of a file (see creat (2)). For 
example, umask 022 removes group and others write permission 
(files normally created with mode 777 become mode 755 ;; files 
created with mode 666 become mode 644 ). 


If ooo is omitted, the current value of the mask is printed. 
Umask is recognized and executed by the shell. 


SEE ALSO 
chmod(1), sh(1). 
chmod(2), creat(2), umask(2) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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NAME 

uname — print name of current UNIX system 
SYNOPSIS 

uname [ -—Snrvma | 
DESCRIPTION . 


Uname prints the current system name of the UNIX system on the 
standard output file. It is mainly useful to determine which system 
one is using. The options cause selected information returned by 
uname (2) to be printed: 


—S print the system name (default). | 
—n print the nodename (the nodename may be a name that the 
system is known by to a communications network). 
-r print the operating system release. 
-V print the operating system version. 
—m print the machine hardware name. 
—a print all the above information. 
SEE ALSO 


uname(2) in the Sys5 UNIX Programmer Reference Manual. 
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unget — undo a previous get of an SCCS file 


SYNOPSIS 


unget [-rsiD] [-s] [—n] files 


DESCRIPTION 
~Unget undoes the effect of a get -e done prior to creating the 
intended new delta. If a directory is named, unget behaves as 
though each file in the directory were specified as a named file, 
except that non-SCCS files and unreadable files are silently ignored. 
lf a name of — is given, the standard input is read with each line 

being taken as the name of an SCCS file to be processed. 


Keyletter arguments apply independently to each named file. 


SEE ALSO 


—rS/D 


Uniquely identifies which delta is no longer 
intended. (This would have been specified by 
get as the “new delta’). The use of this 
keyletter is necessary only if two or more out- 
standing get s for editing on the same SCCS file 
were done by the same person (login name). A 
diagnostic results if the specified S/D is ambigu- 
ous, or if it is necessary and omitted on the com- 
mand line. 


Suppresses the printout, on the standard output, 
of the intended delta’s S/D . 


Causes the retention of the gotten file which 
would normally be removed from the current 
directory. 


delta(1), get(1), help(1), sact(1). 


DIAGNOSTICS 
Use help (1) for explanations. 
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| NAME 
™ uniq — report repeated lines in a file 
SYNOPSIS 


uniq [ -ude [+ n][-n ] ] [ input [ output | | 


DESCRIPTION : 


Uniq reads the input file comparing adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are 
removed; the remainder ig written on the output file. /nput and 
output should always be different. Note that repeated lines must be 
adjacent in order to be found; see sort (7). If the —u flag is used, 
just the lines that are not repeated in the original file are output. 
The —d option specifies that one copy of just the repeated lines is to — 
be written. The normal mode output is the union of the —u and —d 
mode outputs. 


The -c option supersedes —u and -—d and generates an output 
report in default style but with each line preceded by a count of the 
number of times it occurred. 


The n arguments specify skipping an initial portion of each line in 
the comparison: | 


=n The first a fields together with any blanks before each are 
ignored. A field is defined as a string of non-space, non- 
tab characters separated by tabs and spaces from its 
neighbors. 


+n The first nm characters are ignored. Fields are skipped 
before characters. 


SEE ALSO 
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comm(1), sort(1). 
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NAME 
units — conversion program. 


SYNOPSIS 
units 


DESCRIPTION | 7 
Units converts quantities expressed in various standard scales to 
their equivalents in other scales. It works interactively in this 

_ fashion: 
You have: inch 
You want: cm 
| * 2.540000e+ 00 
/ 3.937008e-01 


A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated 
by suffixed positive integers, division by the usual sign: 


You have: 15 Ibs force/in2 
You want: atm 

* 1.020689e+ 00 

/ 9.797299e-01 


Units only does multiplicative scale changes; thus it can convert 
Kelvin to Rankine, but not Celsius to Fahrenheit. Most familiar 
units, abbreviations, and metric prefixes are recognized, together 
with a generous leavening of exotica and a few constants of nature 


including: | | 
pi ratio of circumference to diameter, 
Cc speed of light, 
e ——sCharge on an electron, 
g acceleration of gravity, 


force sameasg, 

mole Avogadro's number, 

water pressure head per unit height of water, 
au _ astronomical unit. 


Pound is not recognized as a unit of mass; Ib is. Compound 
names are run together, (e.g., lightyear ). British units that differ 
from their U.S. counterparts are prefixed thus: brgallon . For a com- 
plete list of units, type: 


cat /usr/lib/unittab 


FILES 
/usr/lib/unittab 
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NAME 
uucp, uulog, uuname — UNIX system to UNIX system copy 
SYNOPSIS 
uucp [ options | source-files destination-file 
uulog [ options | 
uuname [ —I | [ -v ] 
DESCRIPTION 
Uucp. 
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Uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 


system-name!path-name 


where system-name is taken from a list of system names which 
uucp knows about. The system-name may also be a list of names 
such as 


in which case an attempt is made to send the file via the specified 
route, and only to a destination in PUBDIR (see below). Care should 
be taken to insure that intermediate nodes in the route are willing to 
foward information. 


The shell metacharacters ? , * and [...] appearing in path-name 
will be expanded on the appropriate system. 


Path names may be one of: 
(1) a full path name; 


(2) a path name preceded by “user where user is a 
login name on the specified system and is replaced 
by that user's login directory; 


(3) a path name preceded by “/user where user is a 
login name on the specified system and is replaced 
by that user's directory under PUBDIR; 


(4) anything else is prefixed by the current directory. 


If the result is an erroneous path name for the remote system the 
copy will fail. If the destination-file is a directory, the last part of the 
source-file name is used. 


Uucp preserves execute permissions across the transmission and 
gives 0666 read and write permissions (see chmod (2)). 


The following options are interpreted by uucp : 
—d Make all necessary directories for the file copy (default). 
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—f Do not make intermediate directories for the file copy. = = 


—C Use the source file when copying out rather than copying . 
the file to the spool directory (default). 


-C Copy the source file to the spool directory. 


—mfile Report status of the transfer in file. If file is omitted, send 
mail to the requester when the copy is completed. 


—nuser Notify user on the remote system that a file was sent. 


-—esys Send the uucp command to system sys to be executed 
there: (Note: this will only be successful if the remote 
machine allows the uucp command to be executed by 
lusr/lib/uucp/uuxat . ) 


—f Queue job but do not start file transfer process. By default 
a file transfer process starts each time uucp is evoked. 

—| Control writing of the uucp job number to standard output 
(see below). | 


Uucp associates a job number with each request. This job number 
can be used by uustat to obtain status or terminate the job. 


_ The environment variable JOBNO and the -j option are used tocon- _~ 
trol the listing of the uucp job number on standard output. If the 
environment variable JOBNO is undefined or set to OFF, the job ~- 

~number will not be listed (default). If uucp is then invoked with the 
-j Option, the job number will be listed. If the environment variable 
JOBNO is set to ON and is exported, a job number will be written to 
standard output each time uucp is invoked. In this case, the -j 
option will supIess eutpul of the job number. 


ae 


Uulog 
| Uulog queries a summary log of uucp and uux (1C) transactions in 
the file /usr/s pool/uucp/LOGFILE. 


_ The options cause uulog to print logging information: 


—ssys Print information about work involving system sys. If sys is 
not specified, logging information for all systems will be 
printed. 


—uuser Print information about work done for the specified, user . If 
user is not specified then logging information for all users 
will be printed. 


Uuname. 
Uuname lists the uucp names of known systems. The —I option < 
returns the local system name. The —v option will print additional 

— information about each system. A description will be printed for 
each system that has a line of information in /usr/lib/uucp/ADMIN. 
The format of ADMIN is: sysname tab description tab. | 
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FILES 


/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory for receiving and sending 
(PUBDIR) 

/usr/lib/uucp/* other data and program files 

/usr/spool/uucp/SEQF a sequence file containing a_ four-digit 
number used by uucico(im) or uux(1c) to 
record work done by programs 


SEE ALSO 


mail(1), uux(1C). 
chmod(2) in the Sys5 UNIX Programmer Reference Manual. 


WARNING 


BUGS 
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The domain of remotely accessible files can (and for obvious secu- 
rity reasons, usually should) be severely restricted. You will very 
likely not be able to fetch files by path name; ask a responsible per- 
son on the remote system to send them to you. For the same rea- 
sons, you will probably not be able to send files to arbitrary path 
names. As distributed, the remotely accessible files are those 
whose names begin /usr/spool/uucppublic (equivalent to “‘nuucp or 
just ~ ). 

Only the first six characters of a system-name are significant. Any 
excess characters are ignored. 


In order to send files that begin with a dot (e.g., .profile) the files 
must by qualified with a dot. For example: .profile, are correct; 
whereas “prof*, ?profile are incorrect. 


Uucp will not generate a job number for a strictly local transaction. 


All files received by uucp will be owned by uucp . 

The —m option will only work sending files or receiving a single file. 
Receiving multiple files specified by special shell characters ? * 
[...] will not activate the —m option. 

The —m option will not work if all transactions are local or if uucp is 
executed remotely via the —€ option. 

The =n option will function only when the source and destination are 
not on the same machine. 
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NAME 


uuencode,uudecode — encode/decode a binary file for transmission , 


via mail 


SYNOPSIS 


uuencode [ source ] remotedest | mail sys1!sys2!..!decode 
uudecode [ file ] | | 


DESCRIPTION 


Uuencode and uudecode are used to send a binary file via uucp (or 
other) mail. This combination can be used over indirect mail links 
even when uusend(1C) is not available. 


Uuencode takes the named source file (default standard input) and 
produces an encoded version on the standard output. The encoding 
uses only printing ASCII characters, and includes the mode of the 
file and the remotedest for recreation on the remote system. 


Uudecode reads an encoded file, strips off any leading and trailing 
lines added by mailers, and recreates the original file with the speci- 
fied mode and name. 


The intent is that all mail to the user “decode” should be filtered 
through the uudecode program. This way the file is created 
automatically without human intervention. This is possible on the 
uucp network by either using sendmail or by making rmail be a link 
to Mail instead of mail. In each case, an alias must be created in a 
master file to get the automatic invocation of uudecode. 


If these facilities are not available, the file can be sent to a user on 
the remote machine who can uudecode it manually. 


The encode file has an ordinary text form and can be edited by any 
text editor to change the mode or remote name. 


SEE ALSO 


BUGS 
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mail(1), uucp(1C), uuencode(1C), uux(1C). 


The file is expanded by 35% (3 bytes become 4 plus control infor- 
mation) causing it to take longer to transmit. 


The user on the remote system who is invoking uudecode (often 
uucp) must have write permission on the specified file. 
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uustat — uucp status inquiry and job control 


SYNOPSIS 


uustat [ options | 


DESCRIPTION 


Uustat will display the status of, or cancel, previously specified 
uucp commands, or provide general status on uucp connections to 
other systems. The following options are recognized: 


—jjobn 


-kjobn 


—rjobn 


—chour 
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Report the status of the uucp request jobn . If all is 
used for jobn , the status of all uucp requests ts 
reported. An argument must be supplied otherwise the | 
usage message will be printed and the request will fail. 
Kill the uucp request whose job number is jobn . The 
killed uucp request must belong to the person issuing 
the uustat command unless one is the super-user. 
Rejuvenate jobn. That is, jobn is touched so that its 
modification time is set to the current time. This 
prevents uuclean from deleting the job until the jobs 
modification time reaches the limit imposed by uuc/lean. 
Remove the status entries which are older than hour 
hours. This administrative option can only be initiated by 
the user uucp or the super-user. 

Report the status of all uucp requests issued by user . 
Report the status of all uucp requests which communi- 
cate with remote system sys . 

Report the status of all uucp requests which are older 
than hour hours. 

Report the status of all uucp requests which are younger 
than hour hours. 

Report the status of accessibility of machine mch . If 
mch is specified as all , then the status of all machines 
known to the local uucp are provided. 

This is the same as the —m option except that two times 
are printed. The time that the last status was obtained 
and the time that the last successful transfer to that sys- 
tem occurred. 

Report the uucp status using the octal status codes 
listed below. If this option is not specified, the verbose 
description is printed with each uucp request. | 
List the number of jobs and other control files queued for 
each machine and the time of the oldest and youngest 
file queued for each machine. If a lock file exists for that 
system, its date of creation is listed. 


June 22,1985 


UUSTAT(1C) 


UNIX Sys5 UUSTAT(1C) 


When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. 
options -j , -m , -k , -c , -r , can be used with the rest of the other 
options. 


For example, the command: 
uustat —uhdc —smhtsa -y/72 


will print the status of all uucp requests that were issued by user 
hdc to communicate with system mhtsa within the last 72 hours. 
The meanings of the job request status are: 


job-number user remote-system command-time status-time status 


where the stafus may be either an octal number or a verbose 
description. The octal code corresponds to the following descrip- 


Note that only one of the . 


tion: 
OCTAL STATUS 
000001 the copy failed, but the reason cannot be deter- 
mined 
000002 _spermission to access local file is denied 
000004 _—spermission to access remote file is denied 
000010 bad uucp command is generated 
000020 remote system cannot create temporary file 
000040 ~—s cannot copy to remote directory 
000100 cannot copy to local direetory 
000200 _—ilocal system cannot create temporary file 
000400 cannot execute uuCcp 
001000 = copy (partially) succeeded 
002000 _—copy finished, job deleted 
004000 job is queued 
010000 = job killed (incomplete) 
020000 = job killed (complete) 


The meanings of the machine accessibility status are: 


system-name time status 


where time is the latest status time and status is a self-explanatory 
description of the machine status. 


FILES 
- /USt/SpoOol/uUCp spool directory 
/usr/lib/uucp/L_stat system status file 
— /usr/lib/uucp/R_stat request status file 
SEE ALSO 
uucp(1C). 
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NAME 


uuto, uupick — public UNIX-to-UNIX system file copy 


SYNOPSIS 


uuto [ options | source-files destination 
uupick [ -s system ] 


DESCRIPTION 
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Uuto sends source-files to destination . Uuto uses the uucp (1C) 
facility to send files, while it allows the local system to control the file 
access. A source-file name is a path name on your machine. Des- 
tination has the form: 

systemluser 


where system is taken from a list of system names that uucp 
knows about (see uuname ). Logname is the login name of some- 
one on the specified system. 


Two options are available: 


—p Copy the source file into the spool directory before 
transmission. 
—m Send mail to the sender when the copy is complete. 


The files (or sub-trees if directories are specified) are sent to PUB- 
DIR on system , where PUBDIR is a public directory defined in the 
uucp source. Specifically the files are sent to 


PUBDIR, receive user. mysystem: files. 
The destined recipient is notified by mai! (1) of the arrival of files. 


Uupick accepts or rejects the files transmitted to the user. Specifi- 
cally, uupick searches PUBDIR for files destined for the user. For 
each entry (file or directory) found, the following message is printed 
on the standard output: 

from system: [file file-name] [dir dirname] ? 


Uupick then reads a line from the standard input to determine the 
disposition of the file: 


<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir | Move the entry to named directory dir (current 
directory is default). 

a[ oir | Same as m except moving all the files sent from 
system . 

p Print the content of the file. 
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q Stop. 

EOT (control-d) Sameasq. 

lcommand Escape to the shell to do command . 
‘ Print a command summary. 


Uupick invoked with the —ssystem option will only search the PUB- 
DIR for files sent from system . 


FILES 
PUBDIR /usr/spool/uucppublic public directory 


NOTES 
In order to send files that begin with a dot (e.g., .profile) the files 
must by qualified with a dot. For example: .profile, .prof*, .profil? 
are correct; whereas “prof*, ?profile are incorrect. 


SEE ALSO 
mail(1), uucp(1C), uustat(1C), uux(1C). 
_uuclean(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 

uux — UNIX-to-UNIX system Command execution 
SYNOPSIS 

uux [ options | commanda-string 
DESCRIPTION 


Uux will gather zero or more files from various systems, execute a 
command on a specified system and then send standard output to a 
file on a specified system. Note that, for security reasons, many 
installations will limit the list of commands executable on behalf of 
an incoming request from uux . Many sites will permit little more 
than the receipt of mail (see mail (7)) via uux . 


The commana-string is made up of one or more arguments that 
look like a Shell command line, except that the command and file 
names may be prefixed by system-name!. A null system-name is 
interpreted as the local system. 


File names may be one of 
(1) a full path name; 


(2) a path name preceded by “xxx where xxx is a login 
name on the specified system and Is replaced by that user's 


( \ login directory; 
L (3) anything else is prefixed by the current directory. 
As an example, the command 
uux "diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff" 


will get the f1 files from the “usg” and “pwba’” machines, execute a 
diff command and put the results in f1.diff in the local directory. 


Any special shell characters such as <>;] should be quoted either 
by quoting the entire commana-string, or quoting the special char- 
acters as individual arguments. 


Uux will attempt to get all files to the execution system. For files 
which are output files, the file name must be escaped using 
parentheses. For example, the command 


uux aluucp b!/usr/file \(c!/usr/file\) 


will send a uucp command to system “a” to get /usr/file from sys- 
tem “b” and send it to system “c’. | 


Uux will notify you if the requested command on the remote system 

- was disallowed. The response comes by remote mail from the 

| 5 remote machine. Executable commands are listed in 
| /usr/lib/uucp/L.cmds on the remote system. The format of the 
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L.cmds file is: 
cmd,machine1,machine2.... 


If no machines are specified, then any machine can execute cmd. 
If machines are specified, only the listed machines can execute 
cmd. If the desired command is not listed in L.cmds then no 
machine can execute that command. 


Redirection of standard input and output is usually restricted to files 
in PUBDIR. Directories into which redirection is allowed must be 
specified in /usr/lib/uucp/USERFILE by the system administrator. 
See the UUCP Administrator Manual in the Sys5 UNIX Administrator 
Guide. 


The following options are interpreted by uux : 


— The standard input to uux is made the standard input to the 
command-string . 


—n Send no notification to user. 


-mfile Report status of the transfer in file. If file is omitted, send 
mail to the requester when the copy is completed. 


—j Control writing of the uucp job number to standard output. 


Uux associates a job number with each request. This job number « 


can be used by uustat to obtain status or terminate the job. 


The environment variable JOBNO and the —j option are used to con- 
trol the listing of the uux job number on standard output. If the 
environment variable JOBNO is undefined of set to OFF, the job 
number will not be listed (default). If uuco is then invoked with the 
—j option, the job number will be listed. If the environment variable 
JOBNO is set to ON and is exported, a job number will be written to 
standard output each time uux is invoked. In this case, the -j 
option will suppress output of the job number. 


FILES 
/usr/spool/uucp | spool directory — 
/ust/spool/uucppublic public directory (PUBDIR) 
/usr/ib/uucp/* other data and programs 
SEE ALSO 
mail(1), uuclean(1M), uucp(1C). 
BUGS 


Only the first command of a shell pipeline may have a system- 
name!. All other commands are executed on the system of the first 
command. 
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The use of the shell metacharacter * will probably not do what you 
want it to do. The shell tokens << and >> are not implemented. 
Only the first six characters of the system-name are significant. Any 
excess Characters are ignored. 
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NAME. * 
| val — validate SCCS file | 

SYNOPSIS OO 

val — 

val [-s] [-rSID] [-mname] [-ytype] files 


DESCRIPTION 
Val determines if the specified file is an SCCS file meeting the 
characteristics specified by the optional argument list. Arguments to 
val may appear in any order. The arguments consist of keyletter 
arguments, which begin with a —, and named files. 


Val has a special argument, -, which causes reading of the stan- 
dard input until an end-of-file condition is detected. Each line read 
is independently processed as if it were a command line argument 
list. 


Val generates diagnostic messages on the standard output for each 
command line and file processed, and also returns a single 8-bit 
code upon exit as described below. 


The keyletter arguments are defined as follows. The effects of any 
keyletter argument apply independently to each named file on the 
command line. 


—-S The presence of this argument silences the 
. diagnostic message normally generated on 
the standard output for any error that is 
detected while processing each named file on 
a given command line. 


—rSiD The argument value S/D (SCCS /Dentificatio 
| String) is an SCCS delta number. A check is 
made to determine if the S/D is ambiguous (e. 
g., r1 is ambiguous because it physically 
does not exist but implies 1.1, 1.2, etc., which 
may exist) or invalid (e. g., r1.0 or r1.1.0 are 
invalid because neither case can exist as a 
valid delta number). If the S/D is valid and 
not ambiguous, a check is made to determine 
if it actually exists. 


—mname The argument value name is compared with 
the SCCS %M% keyword in file . 
-ytype The argument value type is compared with 


the SCCS %Y% keyword in file . 
The 8-bit code returned by val is a disjunction of the possible errors, 
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r~. I. €., Can be interpreted as a bit string where (moving from left to 
( ) right) set bits are interpreted as follows: 


bit 0 = missing file argument; 

bit 1. - unknown or duplicate keyletter argument; 
bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = S/D is invalid or ambiguous; 

bit 5 = S/D does not exist; 

bit6 = %Y%, -y mismatch; 

bit 7 = %M°%, —m mismatch; 


Note that va/ can process two or more files on a given command 
line and in turn can process multiple command lines (when reading © 
the standard input). In these cases an aggregate code is returned — 
a logical OR of the codes generated for each command line and file 
processed. 


SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1).. 


DIAGNOSTICS 
Use help (1) for explanations. 


~~ BUGS 
q> | Vai can process up to 50 files on a single command line. Any 
number above 50 will produce a core dump. 
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vc — version control 


SYNOPSIS 


ve [—a] [-t] [—cchar] [-s] [keyword=value ... keyword=value] 


DESCRIPTION 
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The vc command copies lines from the standard input to the stan- 
dard output under control of its arguments and contro/ statements 
encountered in the standard input. In the process of performing the 
copy operation, user declared keywords may be replaced by their 
string value when they appear in plain text and/or control state- 
ments. 


The copying of lines from the standard input to the standard output 
is conditional, based on tests (in control statements) of keyword 
values specified in control statements or as vc command argu- 
ments. 


A control statement is a single line beginning with a control charac- 
ter, except as modified by the -t keyletter (see below). The default 
control character is colon (:), except as modified by the -c keyletter 
(see below). Input lines beginning with a backslash (\) followed by a 
control character are not control lines and are copied to the stan- 
dard output with the backslash removed. Lines beginning with a 
backslash followed by a non-control character are copied in their 
entirety. 


A keyword is composed of 9 or less alphanumerics; the first must 
be alphabetic. A value is any ASCII string that can be created with 
ed (1); a numeric value is an unsigned string of digits. Keyword 
values may not contain blanks or tabs. 


Replacement of keywords by values is done whenever a keyword 
surrounded by control characters is encountered on a version con- 
trol statement. The —a keyletter (see below) forces replacement of 
keywords in aif lines of text. An uninterpreted control character may 
be included in a value by preceding it with \. If a literal \ is desired, 
then it too must be preceded by \. 


Keyletter Arguments 


-a Forces replacement of keywords surrounded 
by control characters with their assigned 
value in aif text lines and not just in vc state- 
ments. | 
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—t All characters from the beginning of a line up 


to and including the first fab character are 
ignored for the purpose of detecting a control 
statement. If one is found, all characters up 
to and including the tab are discarded. 


—cchar Specifies a control character to be used in 
place of :. 
-S Silences warning messages (not error) that 


are normally printed on the diagnostic output. 


Version Control Statements 


:dcl keyword[, ..., keyword] 


Used to declare keywords. All keywords must be declared. 


~iasg keyword=value 


Used to assign values to keywords. An asg statement over- 
rides the assignment for the corresponding keyword on the vc 
command line and all previous asg ’s for that keyword. Key- 
words declared, but not assigned values have null values. 


‘if condition 


‘end 
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Used to skip lines of the standard input. If the condition is true 
all lines between the /f statement and the matching end state- 
ment are copied to the standard output. If the condition is 
false, all intervening lines are discarded, including control 
statements. Note that intervening /f statements and matching 
end statements are recognized solely for the purpose of main- 
taining the proper if-end matching. 

The syntax of a condition is: 


<cond> = [ "not" ] <or> 
<or> <and> | <and> "|" <or> 


| 


<and> = <exp> | <exp> "&'" <and> 

<exp> = "("<or> ")" | <value> <op> <value> 
<op> te ee 

<value> 1:= <arbitrary ASCII string> | <numeric string> 


The available operators and their meanings are: 


= equal 

|= not equal 
& and 
| or 
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- greater than | we 
< less than ‘< 

() used for logical groupings 

not may only occur immediately after the /f, and 


when present, inverts the value of the 
entire condition 


The > and < operate only on unsigned integer values (e.g., : 
012 > 12 is false). All other operators take strings as argu- 
ments (e.g., : 012 != 12 is true). The precedence of the 
operators (from highest to lowest) is: 

=I=->< all of equal precedence 

& 
Parentheses may be used to alter the order of precedence. | 
Values must be separated from operators or parentheses by 
at least one blank or tab. 

::text 

Used for keyword replacement on lines that are copied to the 
standard output. The two leading control characters are 
removed, and keywords surrounded by control characters in — 
text are replaced by their value before the line is copied to the © 
output file. This action is independent of the —a keyletter. 


:On 


:off 
Turn on or off keyword replacement on all lines. 


‘ctlchar 
Change the control character to char. 


:msg message 
Prints the given message on the diagnostic output. 


x. ; 
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a ‘err message 
( Prints the given message followed by: 
: ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an 
exit code of 1. 


SEE ALSO 

ed(1), help(1). 
DIAGNOSTICS 

Use help(1) for explanations. 


EXIT CODES 
0 — normal 
1 — any error 
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NAME a 

vi — screen-oriented (visual) display editor based on ex 
SYNOPSIS oo 


vi [ -t tag ] [ -r file |] [-1] [-wn ] [-x ] [ -R ] [ +command 
] name ... 

view [ -t tag ] [ -r fle ] [ -1] [| -wo ] [ -x ] [ -R ] [ +com- 
mand |] name ... 

vedit [ -t tag ] [ -r file ] [-1] [ -wn ][-x ][—-R ] [ +com- 
mand | name ... 


DESCRIPTION 


Vi (visual) is a display-oriented text editor based on an underlying 
line editor ex (7). It is possible to use the command mode of ex 
from within wi and vice-versa. 


When using vi , changes you make to the file are reflected in what 
you see on your terminal screen. The position of the cursor on the 
screen indicates the position within the file. The Vi Quick Reference 

card, the Introduction to Display Editing with Vi and the Ex Refer- 
ence Manual provide full details on using vi. 


INVOCATION 
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The following invocation options are interpreted by wi: 


—t tag Edit the file containing the tag and position the edi- 
tor at its definition. 

—rfile Recover file after an editor or system crash. If file 
is not specified a list of all saved files will be 
printed. 


| | LISP mode; indents appropriately for lisp code, the 
() {} [[ and ]] commands in vi and open are modi- 
fied to have meaning for lisp . 


-wn Set the default window size to n. This is useful 
when using the editor over a slow speed line. 


—X Encryption mode; a key is prompted for allowing 
creation or editing of an encrypted file. 


—R Read only mode; the readonly flag is set, prevent- 
ing accidental overwriting of the file. 


+ command The specified ex command is interpreted before 
editing begins. 


The name argument indicates files to be edited. 


The view invocation is the same as wi except that the readonly flag 
is set. 
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The vedit invocation is intended for beginners. The report flag is set 
to 1, and the showmode and novice flags are set. These defaults 
make it easier to get started learning the editor. 


Vi MODES 
Command Normal and initial mode. Other modes return to 
command mode upon completion. ESC (escape) 
is used to cancel a partial command. 


Input Entered byaiAloOcCsSR. Arbitrary text 
may then be entered. Input mode is normally ter- 
minated with ESC character, or abnormally with 
interrupt. 


Last line Reading input for : / ? or !; terminate with CR to 
execute, interrupt to cancel. 


COMMAND SUMMARY 
Sample commands 


-tt- arrow keys move the cursor 
hjkl same as arrow keys 
itextESC insert text abc 
cwnewESC change word to new 
<. easESC pluralize word 
q x delete a character 
7 dw delete a word 
dd delete a line 
3dd .. 3 lines 
u undo previous change 
ZZ | exit vi, saving changes 
:qiCR quit, discarding changes 
/textCR search for text 
‘U°D scroll up or down 
“ex cmdCR any ex or ed command 


Counts before vi commands 
Numbers may be typed as a prefix to some commands. They are 
interpreted in one of these ways. 


line/column number zG| 

scroll amount “‘D “U 

repeat effect most of the rest 

Interrupting, canceling 

ESC end insert or incomplete cmd 
“9? (delete or rubout) interrupts 
“L reprint screen if “? scrambles it 
“R reprint screen if “L is - key 
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File manipulation Pe 
:wCR write back changes \ 
:qCR quit — 
:q!iCR quit, discard changes 
:e nameCR edit file name 
-e!CR -reedit, discard changes 
7e + nameCR edit, starting at end 
7-e +nCR edit starting at line n 
:e #CR edit alternate file 

. synonym for :e # 

:w nameCR write file name 

:w! nameCR overwrite file name 

:shCR run shell, then return 

:!cmdCR run cmd, then return 

:nCR edit next file in arglist 

in argsCR specify new arglist 

°G show current file and line 

‘ta tagCR to tag file entry tag 

*] ‘ta, following word is tag 
In general, any ex or ed command (such as substitute or global ) 
may be typed, preceded by a colon and followed by a CR. 

Positioning within file a 
“F forward screen 
“B backward screen 
“D scroll down half screen 
“U scroll up half screen 
G go to specified line (end default) 

/pat next line matching pat 
?pat prev line matching pat 
n repeat last / or ? 

N reverse last / or ? 
/pat/+n noth line after pat 
?pat?-n noth line before pat 

]] next section/function 

[[ previous section/function 
( beginning of sentence 
) end of sentence 

{ beginning of paragraph 
} end of paragraph 

% find matching ( ) { or } 

Adjusting the screen 

. A 
L clear and redraw : 
“R retype, eliminate @ lines SN 
zCR redraw, current at window top 
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z—-CR 
z.CR 


/patiz—CR 


zn.CR 
“E 
ay, 
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... at bottom 

... at center 

pat line at bottom 

use n line window 

scroll window down 1 line 
scroll window up f line 


Marking and returning 


Line positioning 


AS 


ad 


mx 
~X 


X 


CR 
tor j 
tork 


move cursor to previous context 
... at first non-white in line 

mark current position with letter x 
move cursor to mark x 

... at first non-white in line 


top line on screen 

last line on screen 

middle line on screen 

next line, at first non-white 


previous line, at first non-white 


return, same as + 
next line, same column 
previous line, same column 


Character positioning 


first non white 
beginning of line 
end of line 

forward 

backwards 

same as «+ 

same as > 

find x forward 

f backward 

upto x forward 

back upto x 

repeat last f F t or T 
inverse of ; 

to specified column 
find matching ( { ) or } 


Words, sentences, paragraphs 


WwW 
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back word 

end of word 

to next sentence 
to next paragraph 
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( back sentence 
{ back paragraph 
W blank delimited word 
B back W | 
E to end of W 
Commands for LISP Mode 
) Forward s-expression 
} ... but do not stop at atoms 
( Back s-expression 
{ ... but do not stop at atoms 
Corrections during insert 
“H erase last character 
“W erase last word 
erase your erase, same as “H 
kill your kill, erase input this line 
\ quotes *H, your erase and kill 
ESC ends insertion, back to command 
“? interrupt, terminates insert 
*D backtab over autoindent 
rD kill autoindent, save for next 
0°D ... but at margin next also 
“V quote non-printing character 


Insert and replace 
a append after cursor 
i insert before cursor 
A append at end of line 
I insert before first non-blank 
fe) open line below 


0 open above 

rx replace single char with x 

RtextESC replace characters 
Operators 


Operators are followed by a cursor motion, and affect all text that 
would have been moved over. For example, since w moves over a 
word, dw deletes the word that would be moved over. Double the 
operator, e.g. dd to affect whole lines. | 


d delete 

Cc change 

y yank lines to buffer 
< left shift 

> right shift 

{ 


filter through command 
indent for Lisp 
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_ Miscellaneous Operations | 
C change rest of line (c$) 
delete rest of line (d$) 
substitute chars (cl) 
substitute lines (cc) 
join lines 
delete characters (dl) 
... before cursor (dh) 
yank lines (yy) 


<xK<xx C= MOO 


Yank and Put 
Put inserts the text most recently deleted or yanked. However, if a 
buffer is named, the text in that buffer is put instead. 


p put back text after cursor 

P put before cursor 

"xp out from buffer x 

"Xy yank to buffer x 

"xd delete into buffer x 

Undo, Redo, Retrieve 

u undo last change 

| U restore current line 
q ‘y ~ repeat last change 
ee "dp retrieve a’th last delete 
AUTHOR 


Vi and ex were developed by The University of California, Berkeley 
California, Computer Science Division, Department of Electrical 
Engineering and Computer Science. 


SEE ALSO 
ex (1). 


Vi Quick Reference Card. 
An Introduction to Display Editing with Vi, and Ex Reference 
Manual in the Sys5 UNIX Documentation Workbench. 


CAVEATS AND BUGS 
Software tabs using “T work only immediately after the autoindent. 


Left and right shifts on intelligent terminals do not make use of insert 
and delete character operations in the terminal. 


There should be an interactive he/p facility and a tutorial suited for 
beginners. 


() 
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NAME 


vtty - connect to a remote host via NOS 


SYNOPSIS 


vtty host 


DESCRIPTION 


Vity establishes a cu(1) link between one UNIX system and another. 
Both systems must be running the Plexus Network Operating Sys- 
tem (NOS). 


Vtty scans the file /usr‘lib’nos'vtconf for the hosf name specified, 
and remembers the minor device number(s) associated with that 
host. It then searches the directory /dev for special files that have 
that minor device number. If it finds an entries in /dev within the 
appropriate minor device number range, it checks /usr’spool/uucp 
for lock files associated with these devices, and initiates a cu pro- 
cess with the first available device. 


All normal setup for cu and the virtual terminal facility of NOS must 
be done on both nodes for this command to work. In particular, the 
file /usr/lib/uucp/L-devices must be set up properly, and virtual ter- 
minals and ports must be established in ail connecting nodes’ /dev 
directories and configured in their /usr/lib/nos/vtconf files. 


FILES 
‘usrilib/nos/vtconf virtual terminal/port configuration 
file 
/usr/spool/uucp cu lock files here 
idev.™ | virtual terminal ports located here 
/usr’spool/uucp/L-devices virtual terminals defined for vtty 
fetciinittab virtual ports activated on receiving 
host 

EXAMPLE 


Assuming the system plx is running NOS, and one or more virtual 
ports have been established on plx in /dev, and the local host's 
/usr/lib/nos/vtconf file and /dev directory have assigned at least 
one virtual terminal to plx, you can connect to plx by typing 


> vity pix 
If successful, the message 
Connected 


appears, followed by the normal login prompt. 


DIAGNOSTICS 
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Cannot open dev 
The directory dev cannot be accessed. 
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Cannot open ‘usr/lib/nos‘vtconf : 
The file /usr/lib'nos’vtconf cannot be opened or does not vet 


<name> not found in vtconf 
The host name name is not a configured host. 


No vt device available. Try again. — 
All ports are in use. Try again later. 


time-out to remote host 
The remote host is down or not enabled: or ‘the local’ host is not 
enabled on the remote host. See node({1). oe 


time-out period not expired 

time-out to remote host 

After receiving the time-out to remote host on the previous vity 
request, the time-out period has not expired. 


‘usr/libinosivtconf on remote host does not allow remote login. 
/usr‘lib/nos’vtconf on the remote host does not have a a egies dev- 
ice defined to receive remote logins. 


device not defined for virtual terminal in ;usr‘libinos:vtcont. 
User attempted to cu to a device not defined in /usr‘lib‘nos’vtconf. 


fogin port on remote host unavailable 
On the remote host, there is no getty for the virtual terminal port. 


There is no semaphore to prevent collisions between vity requests. 
Hence the error message indicating lack of devices may be errone- 
ous. 
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NAME | a — 
+ wait — await completion of process. oe % 
SYNOPSIS _ 
wait 
DESCRIPTION 


Wait until all processes started with & have completed, and report 
~ on abnormal terminations. | 
Because the wait (2) system call must be executed in the parent 
process, the. shell itself executes wait , without creating a new pro- 
cess. 
SEE ALSO 
sh(1). | 7 
wait(2) in the Sys5 UNIX Programmer Reference Manual. 
BUGS : 
Not all the processes of a 3- or more-stage pipeline are children of 
the shell, and thus cannot be waited for. 
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NAME 
wc — word count 


SYNOPSIS 
we [ -lwc | [ names | 


DESCRIPTION : 
We counts lines, words, and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for 
all named files. A word is a maximal string of characters delimited 
by spaces, tabs, or new-lines. 


The options |, w , and c may be used in any combination to specify 
that a subset of lines, words, and characters are to be reported. | 
The default is -lwe . 


When names are specified on the command line, they will be 
printed along with the counts. 
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NAME 
what — identify SCCS files 


SYNOPSIS 
what [-s] files 


DESCRIPTION : 
What searches the given files for all occurrences of the pattern that 
get (1) substitutes for %Z% (this is @(#) at this printing) and prints 
out what follows until the first ", > , new-line, \ , or null character. 
For example, if the C program in file f.c contains 
char ident{] = "(a(#)identification information"; | 
and f.c is compiled to yield f.o and a.out, then the command 


what f.c f.o a.out 


will print 
iC: 
identification information 
f.0: 
identification information 
a.out: 


identification information 


What is intended to be used in conjunction with the command get 
(1), which automatically inserts identifying information, but it can 
also be used where the information is inserted manually. Only one 
option exists: 


-s Quit after finding the first occurrence of pat- 
| tern in each file. 
SEE ALSO 
get(1), help(1). 
DIAGNOSTICS 


Exit status is 0 if any matches are found, otherwise 1. Use help (1) 
for explanations. 


BUGS 
It is possible that an unintended occurrence of the pattern @(#) 
could be found just by chance, but this causes no harm in nearly all 
cases. 
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NAME 


who — who is on the system 


SYNOPSIS 


who [-—uTHIipdbrtasq ] [ file ] 
who am | 
who am | 


DESCRIPTION 
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Who can list the user’s name, terminal line, login time, elapsed time 
since activity occurred on the line, and the process-ID of the com- 
mand interpreter (shell) for each current UNIX system user. It exam- 
ines the /etc/utmp file to obtain its information. If file is given, that 
file is examined. Usually, file will be /etc/wtmp , which contains a 
history of all the logins since the file was last created. 


Who with the am i or am I option identifies the invoking user. 


Except for the default -—s option, the general format for output 
entries is: 


name [state] line time activity pid [comment] [exit] 


With options, who can list logins, logoffs, reboots, and changes to 
the system clock, as well as other processes spawned by the init 
process. These options are: 


—u This option lists only those users who are currently logged in. 
The name is the user's login name. The /ine is the name of 
the line as found in the directory /dev . The fime is the time 
that the user logged in. The activity is the number of hours 
and minutes since activity last occurred on that particular line. 
A dot (.) indicates that the terminal has seen activity in the 
last minute and is therefore ‘current’. If more than twenty- 
four hours have elapsed or the line has not been used since 
boot time, the entry is marked old. This field is useful when 
trying to determine whether a person is working at the termi- 
nal or not. The pid is the process-ID of the user’s shell. The 
comment is the comment field associated with this line as 
found in /etc/inittab (see inittab (4)). This can contain infor- 
mation about where the terminal is located, the telephone 
number of the dataset, type of terminal if hard-wired, etc. 


May 27, 1985 


at 


—a 
-s 


FILES 


UNIX: Sys5 WHO(1) 


This option is the same as the —u option, except that the | 
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state of the terminal line is printed. The state describes 
whether someone else can write to that terminal. A + 
appears if the terminal is writable by anyone; a — appears if it 
is not. Root can write to all lines having a + or a — in the 
State field. If a bad line is encountered, a ? is printed. 


This option lists only those lines on which the system is wait- 
ing for someone to login. The name field is LOGIN in such 


cases. Other fields are the same as for user entries except 


that the state field does not exist. 


This option will print column headings above the regular out- 
put. | 


This is a quick who, displaying only the names and the 
number of users currently logged on. When this option is 


~ used, all other options are ignored. 


This option lists any other process which ts currently active 
and has been previously spawned by init . The name field is 
the name of the program executed by init as found in 
/etc/inittab . The state , line , and activity fields have no 
meaning. The comment field shows the id field of the line 
from /etc/inittab that spawned this process. See inittab (4). 


This option displays all processes that have expired and not 
been respawned by init . The exit field appears for dead 
processes and contains the termination and exit values (as 
returned by wait (2)), of the dead process. This can be use- 
ful in determining why a process terminated. 


This option indicates the time and date of the last reboot. 
This option indicates the current run-fevel of the init process. 


This option indicates the last change to the system clock (via 


the date (1) command) by root . See su (7). 


This option processes /etc/utmp or the named file with all 
options turned on. 


This option is the default and lists only the name , line , and 


time fields. 


/etc/utmp 
/etc/wtmp 
/etc/inittab 


SEE ALSO 


date(1), login(1), mesg(1), su(1). 
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wait(2), inittab(4), utmp(4) in the Sys5 UNIX Programmer Reference 
Manual. 
init(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 


write — write to another user 


SYNOPSIS 


write user [ line | 


DESCRIPTION 
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Write copies lines from your terminal to that of another user. When 
first called, it sends the message: 


Message from yourname (tty ?? ) [ date ]... 


to the person you want to talk to. When it has successfully com- 
pleted the connection, it also sends two bells to your own terminal to 
indicate that what you are typing is being sent. 


The recipient of the message should write back at this point. Com- 
munication continues until an end of file is read from the terminal, 
an interrupt is sent, or the recipient has executed “mesg n". At that 
point write writes EOT on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the 
line argument may be used to indicate which line or terminal to send 
to (e.g., ttyOO ); otherwise, the first writable instance of the user 
found in /etc/utmp is assumed and the following message posted: 


user is logged on more than one place. 
You are connected to "terminal". 

Other locations are: 

terminal 


Permission to write may be denied or granted by use of the 
mesg({1) command. Writing to others is normally allowed by default. 
Certain commands, in particular nroff (1) and pr (71) disallow mes- 
sages in order to prevent interference with their output. However, if 
the user has super-user permissions, messages can be forced onto 
a write-inhibited terminal. 


If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 


The following protoco! is suggested for using write : when you first 
write to another user, wait for them to write back before starting to 
send. Each person should end a message with a distinctive signal 
(i.e., (0) for “over’) so that the other person knows when to reply. 
The signal (00) (for “over and out’) is suggested when conversation 
is to be terminated. | 
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FILES 
fetc/utmp to find user 
/bin/sh_ to execute ! 
SEE ALSO 
mail(1), mesg(1), nroff(1), pr(1), sh(1), who(1). 
Sys5 UNIX Documenter’s Workbench Introduction and Reference 
Manual. 
DIAGNOSTICS 


“user is not logged on" if the person you are trying to write to is 
not logged on. 

“Permission denied” if the person you are trying to write to denies 
that permission (with mesg). 
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x9700 - prepare nroff documents for the Xerox 9700 printer 


SYNOPSIS 
x9700 [-1 | -2] [ [-f] file] [-h indent] [-v indent] [-I feng] 
[-{[ p |] k mask [n] ] [ [-o orient] [-s style] [-T c] [files] 


DESCRIPTION 
The x9700 command reads the named files and writes standard out- 
put which is suitable to be sent to the Xerox 9700 printer. The spe- 
cial name — means standard input. Each file will begin on a new 
page. If no files are specified, then x9700 reads from standard 
inout. Options and their meanings: 


—1 
—2 
—f file 


—h indent 


—v indent 


—| length 


—Ik mask n 
—pk mask n 
—k maskn 


—O orient 


print output on one side of the page 
print output on both sides of the page 


Take input from file. This option is necessary to pro- 
cess file names which begin with a hyphen. 


horizontal indent: offset output indent units to the right. 
A c appended to indent sets the unit of offset to cen- 
timeters; an /, sets the unit to inches; neither, sets the 
unit to character positions. The default indent is zero. 
Fractional character positions are ignored. 


Vertical indent: offset output indent lines from top of 


page. Default is zero. 


Print fength lines per page. Defaults for the fonts are 
given below. A /fength of zero obtains the default. 


Overlay output with preprinted mask. The /k overlays 
the mask in landscape orientation; the pk, in portrait 
orientation. The k alone uses the current orientation. 
The default mask is none. A number following the 
mask name specifies the page on which to overlay the 
mask. If no number follows the mask name, then all 
pages not specifically named are overlaid with the 
mask. Available masks are installation-dependant. 


Page orientation, either portrait or landscape, with 
port and land respectively, acceptable abbreviations. 
Each font style has a default, given below. Specifying 
an empty orientation obtains the default. 
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-s style Select font style. Current possibilities and default 
values: 
style abbr default portrait landscape 
orient length width length width 
elite elit port (a ie 102 51 131 
gothic goth port 66 85 S| 110 
goth24 port 33 42 29 95 
mini port 137 131 106 131 
pica port 66 85 oa 110 
times14 port 46 “90 36 “118 
times28 port 23 “45 18 ‘Og 
vintage vint port 71 102 55 131 
vint20 port 35 oH 27 66 
xerox xrox land 99 116 77 131 
xerox18 land 44 58 34 75 


Note that the lengths and widths are maximum values 
for a page and make no provision for margins. The ~ 
indicates approximate widths for proportionally spaced 
fonts. The default style is vintage. Both the style 
names and their abbreviations are accepted. Not all 
styles have all fonts, and not all fonts have a full char- 
acter set (including the full TX train). A summary of 
available combinations appears below. Note: these 
fonts are under development and subject to 
change without notice. 


-T Cc If and only if c is X, then x9700 expects input from 
nroff with the -TX option. 


Options may be repeated and may appear in any order. The space 
between an option and its argument may be omitted. The options 
are cumulative and apply only to succeeding file names. Thus 


x9700 -o port -h 10 file1 -o land file2 


prints file? in portrait orientation and file2 in landscape, but indents 
both files by 10 characters. 
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ESCAPES | _ 
The command xX9700 recognizes four control characters (back- : 
space, formfeed, horizontal tab, and carriage return) and the follow- “—~ 
ing set of escapes: | | 


escape sequence meaning from NROFF 
esc XC hyperascii c (‘c’ |0200) 

esc esc C hyperascii c (‘c' |0200) 

esc B bold font fB 
esc R © Roman font \fR 
esc | Italic font \f 
esc L logo font 

esc D reverse half-line feed \u 
esc U half-line feed \d 
esc \n reverse line feed 

eSC SI intensify shading 

esc SO lessen shading 


The half-line motions effect superscripts and subscripts, but the TX 
train contains only a limited number of these. There are three levels 
of shading available: dark (character e9), darker (e8), and darkest ~~ 


(C4). = 
input this column to get 

none none 
\33\1 7level 1 (dark) level 1 (dark) 
\33\1 Zlevel 2 (darker) level 2 (darker) 
\33\1 7level 3 (darkest) level 3 (darkest) 
\33\16back to level 2 back to level 2 
\33\16back to level 1 back to level 1 
\33\16back to none back to none 

SEE ALSO 

nroff(1). 
EXCEPTIONS 


Lines that exceed the page width are truncated. Page breaks occur 
not only at the logical end of page (controlled by the -l option), but 
also at the physical end of page (controlled by the machine). Lines 
which exceed the latter limit are usually forced to an extra, overflow 
page. The number of lines on a page includes the indent of the -v 
option. 


It is difficult to get to all of the 7X train. ‘ee 
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_. FONT SUMMARY 
j style bold-italic graph 
| port land port land 


elite y y n n 
Gothic y y n n 
goth24 n n n n 
mini n n n n 
pica y y n n 
times14 n n n n 
times28 n n n n 
vintage y y y y 
vint20 n n y y 
xerox y y n n 
xerox18 n n n n 


DIAGNOSTICS 

“missing parameter to -option" 

"can't open file” 

"unsupported style/orientation combination" 
“bad mask name" 
"bad horizontal indent specification" 

"bad page length specification’ 

‘bad vertical indent specification” 


Check parameter list. 


“page length larger than max" 
X9700 has been directed to place more than 140 lines 
On a page. | 


‘attempt to back off page” — 
An attempt to field a reverse line feed would cause a 
return to a previous page. 


"file too wide" 7 
X9700 has encountered a line with more than 132 char- | 
acters on it. This usually happens when input not pro- 
duced with nroff -TX is given to x9700 with the -7TX 
option. 


"unknown escape sequence" 
X9700 has been given an escape sequence which does 
not correspond to a reverse line feed, a font change, a 
shade change, or a hyperascii character. Escape 
sequences are introduced with an ascii esc character 
(octal 33). This usually happens when -7X is not sup- 
plied to nroff. 
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"too many masks" bee sate its 
~X9700 allows a noteN of only ten seaaisies mae pedi 
cations. * 


"page too dense" 

_ &9700 has encountered a page with too much over- 
printing. The cause may be too much backspacing or 
too many font changes. It may be small comfort that 
even if the x9700 program could format the page, the 
Xerox printer would probably fail to print it. 


"internal error’ 
"machine seized" 
Get heip. 


EXAMPLES 
The following examples do not include the final pipeline to direct the 


output to the Xerox 9700 printer, because that is an installation-. 


dependent procedure. 

To obtain standard memo format: 
nroff -rA3 -rE1 -rU1 -rL71 -TX -cm file | 
x9700 -h10 -TX -k print 

To obtain manual page: 


nroff -TX -man file | 
x9700 -I66 -v3 -h10 -TX 


To obtain this manual page: 


“nroff -man -TX file | 
x9700 -hi2 -v2 -I66 -TX -k prini 1 -k prin2 2 -k prin3 3 \ 
-Ik print 4 -Ik prin2 5 -k vgraf 6 -k sdisc 7 


~ To obtain viewgraphs: 


nroff -TX - file <<eof | 
pl 35 
A 45 
eof | | 
~ x9700 -s vint20 -TX 
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_ NAME 
\ 


xargs — construct argument list(s) and execute command 


~ SYNOPSIS 


xargs [flags] [ command [initial-arguments ] |] 


DESCRIPTION 
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Xargs combines the fixed initial-arguments with arguments read 
from standard input to execute the specified command one or more 
times. The number of arguments read for each command invoca- 
tion and the manner in which they are combined are determined by 
the flags specified. 


Command , which may be a shell file, is searched for, using one's 
$PATH. If Command is omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new- 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted. Characters 
enclosed in quotes (single or double) are taken literally, and the del- 
imiting quotes are removed. Outside of quoted strings a backslash 
(\) will escape the next character. 


Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(Exception: see -i flag). Flags -1, -1, and —n determine how argu- 
ments are selected for each command invocation. When none of 
these flags are coded, the initial-arguments are followed by argu- 
ments read continuously from standard input until an internal buffer 
is full, and then command is executed with the accumulated args. 
This process is repeated until there are no more args. When there 
are flag conflicts (e.g., -l vs. -n ), the last flag has precedence. 
Flag values are: 


—Inumber Command is executed for each non-empty 
number lines of arguments from standard 
input. The jiast invocation of command will 
be with fewer lines of arguments if fewer than 
number remain. A line is considered to end 
with the first new-line unless the last charac- 
ter of the line is a blank or a tab; a trailing 
blank/tab signals continuation through the 
next non-empty line. If number is omitted, 1 
is assumed. Option —x is forced. 
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—ireplstr Insert mode: command is executed for each an 
, line from standard input, taking the entire line | 


. . . . « ¢ aga \ , 
as a single arg, inserting it in initial- —— 


arguments for each occurrence of repi/str. A 
maximum of 5 arguments in initial-arguments 
may each contain one or more instances of 
replstr . Blanks and tabs at the beginning of 
each line are thrown away. Constructed 
arguments may not grow larger than 255 
characters, and option —x is also forced. {} 
is assumed for repistr if not specified. 


—nnumber Execute command using as many standard 
input arguments as possible, up to number 
arguments maximum. Fewer arguments will 
be used if their total size is greater than size 
characters, and for the last invocation if there 
are fewer than number arguments remaining. 
If option —x is also coded, each number argu- 
ments must fit in the size limitation, else 
xargs terminates execution. 


-t | Trace mode: The command and each con- — 
structed argument list are echoed to file 
descriptor 2 just prior to their execution. - 


—p Prompt mode: The user is asked whether to 
execute command each invocation. Trace 
mode (-t) is turned on to print the command 
instance to be executed, followed by a ?... 
prompt. A reply of y (optionally followed by 
anything) will execute the command; anything 
else, including just a carriage return, skips 
that particular invocation of command . 


—X Causes xargs to terminate if any argument 
list would be greater than size characters; —x 
is forced by the options -i and —I . When nei- 
ther of the options —i , -I , or —n are coded, 
the total length of all arguments must be 
within the size limit. | 
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—Ssize The maximum total size of each argument list 


is set to size characters; size must be a posi- 
tive integer less than or equal to 470. If —s is 
not coded, 470 is taken as the default. Note 
that the character count for size includes one 
extra character for each argument and the 
count of characters in the command name. 


—eeofstr Eofstr is taken as the logical end-of-file string. 
Underbar (_) is assumed for the logical EOF 
string if -e is not coded. The value —e with 
no eofstr coded turns off the logical EOF 
string capability (underbar is taken literally). 
Xargs reads standard input until either end- 
of-file or the logical EOF string is encoun- 


tered. 


Xargs will terminate if either it receives a return code of —1 from, or 
if it cannot execute, command . When command is a shell program, 
it should explicitly exit (see sh (7)) with an appropriate value to 
avoid accidentally returning with -1. 


EXAMPLES 


The following will move all files from directory $1 to directory $2, and 
echo each move command just before doing it: 


Is $1 | xargs -i +t mv $14} $2/{} 


The following will combine t 
mands onto one line, whi 3 


e output of the parenthesized com- 


nen echoed to the end of file /og: 
(logname; date; "ho $0 $«) | xargs >>log 


The user is asked which files in the current directory are to be 
archived and archives them into arch (1.) one at a time, or (2.) 
many at a time. . 


1. Is | xargs —p -I ar r arch 
2. Is | xargs —-p +1 | xargs ar r arch 


The following will execute diff (7) with successive pairs of argu- 
ments originally typed as shell amen: 


echo $* | xargs —n2 diff 


SEE ALSO 


sh(1). 


DIAGNOSTICS 
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Seif-explanatory. 
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SEE ALSO 
lex(1). 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


YACC—Yet Another Compiler Compiler in the Sys5 UNIX Support 
Tools Guide . | 


DIAGNOSTICS | 
The number of reduce-reduce and shift-reduce conflicts is reported 
on the standard error output; a more detailed report is found in the 
y.output file. Similarly, if some rules are not reachable from the 
start symbol, this is also reported. 


BUGS 
Because file names are fixed, at most one yacc process can be 
active in a given directory at a time. 
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FILES | a 
strings Data base of strings \ 
ae Massaged C source | a 
XS.C C source for definition of array ‘xstr’ 
/tmp/xs* . — Temp file when ‘xstr name’ doesn't touch strings 

NOTES 


This command is based on a similar one from the University of Calli- 
fornia at Berkeley. : 

SEE ALSO | 
mkstr(1) 

BUGS 
lf a string is a suffix of another string in the data base, but the 
shorter string is seen first by xstr both strings will be placed in the 
data base, when just placing the longer one there will do. 
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NAME 

yacc — yet another compiler-compiler 
SYNOPSIS 

yacc [ -vdit | grammar 
DESCRIPTION 


Yacc converts a context-free grammar into a set of tables for a sim- 
ple automaton which executes an LR(1) parsing algorithm. The 
grammar may be ambiguous; specified precedence rules are used 
to break ambiguities. 


The output file, y.tab.c , must be compiled by the C compiler to pro- 
duce a program yyparse . This program must be loaded with the 
lexical analyzer program, yylex , as well as main and yyerror , an 
error handling routine. These routines must be supplied by the 
user; /ex (7) is useful for creating lexical analyzers usable by yacc . 


If the —v flag is given, the file y.output is prepared, which contains a 
description of the parsing tables and a report on conflicts generated 
by ambiguities in the grammar. 


If the —d flag is used, the file y.tab.h is generated with the #define 
statements that associate the yacc-assigned ‘token codes” with the 
user-declared “token names’. This allows source files other than 
y.tab.c to access the token codes. 


If the —I flag is given, the code produced in y.tab.c will not contain 
any #line constructs. This should only be used after the grammar 
and the associated actions are fully debugged. 


Runtime debugging code is always generated in y.tab.c under con- 
ditional compilation control. By default, this code is not included 
when y.tab.c is compiled. However, when yacc ‘s -t option is 
used, this debugging code will be compiled by default. Independent 
of whether the -t option was used, the runtime debugging code is 
under the control of YYDEBUG , a pre-processor symbol. If YYDE- 
BUG has a non-zero value, then the debugging code is included. If 
its value is zero, then the code will not be included. The size and 
execution time of a program produced without the runtime debug- 
ging code will be smaller and slightly faster. 

FILES 
y.output 
y.tab.c 
y.tab.h defines for token names 
yacc.tmp, 
yacc.debug, yacc.acts temporary files 
/usr/lib/yaccpar parser prototype for C programs 
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NAME 


xstr — extract strings from C programs to implement shared strings 


SYNOPSIS 


/usr/plx/xstr [ -—c ] [ — ] [ file ] 


DESCRIPTION 
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Xstr maintains a file Strings into which strings in sainponeal parts of 
a large program are hashed. These strings are replaced with refer- 
ences to this common area. This serves to implement shared con- 


stant strings, most useful if they are also read-only. 


The command 
xstr —c name 


will extract the strings from the C source in name, replacing string 
references by expressions of the form (&xstr[number]) for some 
number. An approporiate declaration of xstr is prepended to the file. 
The resulting C text is placed in the file x.c, to then be compiled. 
The strings from this file are placed in the strings data base if they 
are not there already. Repeated strings and strings which are suf- 
fices of existing strings do not cause changes to the data base. 


After all components of a large program have been compiled a file 


_xs.c declaring the common xstr space can be created by a com- 


mand of the form 
xstr 
This xs.c file should then be compiled and loaded with the rest of 


the program. If possible, the array can be made read-only (shared) 
saving space and swap overhead. 


Xstr can also be used on a single file. A command 
xstr name 


creates files x.c and xs.c as before, without using or affecting any 
Strings file in the same directory. 


It may be useful to run xstr after the C preprocessor if any macro 
definitions yield strings or if there is conditional code which contains 
strings which may not, in fact, be needed. Xstr reads from its stan- 
dard input when the argument ‘—' is given. An appropriate com- 
mand sequence for running xstr after the C preprocessor is: 


cc —E name.c|xstr -c — 
CC -C X.C 
mv x.0 name.o 


Xstr does not touch the file strings unless new items are added, 
thus make can avoid remaking xs.o unless truly necessary. 
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™ NAME 


intro — introduction to games 


~ DESCRIPTION 
This section describes the recreational and educational programs 
found in the directory /usr/games . The availability of these pro- 
grams may vary from system to system. 
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NAME 

arithmetic — provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetic [| +-—x/ ] [ range ]. 
DESCRIPTION | oe 


Arithmetic types out simple arithmetic problems, and waits for an 
answer to be typed in. If the answer is correct, it types back 
“Right!", and a new problem. If the answer is wrong, it replies 
“What?”, and waits for another answer. Every twenty problems, it 
publishes statistics on correctness and the time required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be 
generated; + ,-,x, and/ respectively cause addition, subtraction, 
multiplication, and division problems to be generated. One or more 
characters can be given; if more than one is given, the different 
types of problems will be mixed in random order; default is +—-. 


Range is a decimal number; all addends, subtrahends, differences, 
multiplicands, divisors, and quotients will be less than or equal to 
the value of range . Default range is 10. 


At the start, all numbers less than or equal to range are equallyed 
likely to appear. If the respondent makes a mistake, the numbers in 
the problem which was missed become more likely to reappear. 


As a matter of educational philosophy, the program will not give 
correct answers, since the learner should, in principle, be able to 
calculate them. Thus the program is intended to provide drill for 
someone just past the first learning stage, not to teach number facts 
de novo. For almost all users, the relevant statistic should be time 
per problem, not percent correct. 
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NAME 
( a back — the game of backgammon 
SYNOPSIS 


/usr/games/back 


DESCRIPTION : 


BUGS 
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Back is a program which provides a partner for the game of back- 
gammon. It is designed to play at three different levels of skill, one 
of which you must select. In addition to selecting the opponent's 
level, you may also indicate that you would like to roll your own dice 
during your turns (for the superstitious players). You will also be 
given the opportunity to move first. The practice of each player rol- 
ling one die for the first move is not incorporated. 


The points are numbered 1—24, with 1 being white’s extreme inner 
table, 24 being brown's inner table, 0 being the bar for removed 
white pieces and 25 the bar for brown. For details on how moves 
are expressed, type y when back asks “Instructions?” at the begin- 
ning of the game. When back first asks “Move?’, type ? to see a 
list of move options other than entering your numerical move. 


When the game is finished, back will ask you if you want the log. If 
you respond with y , back will attempt to append to or create a file 
back.log in the current directory. 


/usrigames/lib/backrules rules file 
/tmp/b* log temp file 
back.log log file 


The only level really worth playing is “expert”, and it only plays the 
forward game. 

Back will complain loudly if you attempt to make too many moves in 
a turn, but will become very silent if you make too few . 

Doubling is not implemented. 

Instructions tend to run off the page. 
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NAME 
bj — the game of black jack 
SYNOPSIS 
/usr/games/bj 
Pee 
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Bj is a serious attempt at simulating the dealer in the game of Baek 


Jack (or twenty-one) as might be found in Reno. The eOHOWING rules 


apply: 
The bet is $2 every hand. 


A player “natural” (black jack) pays $3. A dealer natural loses 
$2. Both dealer and player naturals is a “push” (no money 
exchange). 


If the dealer has an ace up, the player is allowed to make an 
“insurance” bet against the chance of a dealer natural. If this 
bet is not taken, play resumes as normal. If the bet is taken, it 
is a side bet where the player wins $2 if the dealer has a 
natural and loses $1 if the dealer does not. 


If the player is dealt two cards of the same value, he is 
allowed to “double’. He is allowed to play two hands, each 
with one of these cards. (The bet is doubled also; $2 on each 
hand.) 


If a dealt hand has a total of ten or eleven, the player may 
“double down”. He may double the bet ($2 to $4) and receive 
exactly one more card on that hand. 


Under normal play, the player may “hit” (draw a card) as long 
as his total is not over twenty-one. If the player “busts” (goes 
over twenty-one), the dealer wins the bet. 


When the player “stands” (decides not to hit), the aia hits 
until he attains a total of seventeen or more. If the dealer 
busts, the player wins the bet. 


If both player and dealer stand, the one with the aides total 
wins. A tie is a push. 


The machine deals and keeps score. The following questions will 
be asked at appropriate times. Each question is answered by y fol- 
lowed by a new-line for “yes”, or just new-line for “no 


”) (means, “do you want a hit?”) 
Insurance? 
Double down? 


Every time the deck is shuffled, the dealer so states and the 
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BUGS 
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“action” (total bet) and “standing” (total won or lost) is printed. To 
exit, hit the interrupt key (DEL) and the action and standing will be 
printed. 


Doesn't work. 
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NAME 


craps —the game of craps. 


SYNOPSIS 


/usr/games/craps 


DESCRIPTION 


Page 1 


Craps is a form of the game of craps that is played in Las Vegas. 
The program simulates the roller , while the user (the p/ayer ) 
places bets. The player may choose, at any time, to bet with the 
roller or with the House . A bet of a negative amount is taken as a 
bet with the House, any other bet is a bet with the roller. 


The player starts off with a “bankroll” of $2,000. 
The program prompts with: 
bet? 
The bet can be all or part of the player's bankroll. Any bet over the 


total bankroll is rejected and the program prompts with bet? until a 
proper bet is made. 


Once the bet is accepted, the roller throws the dice. The following 
rules apply (the player wins or loses depending on whether the bet 
is placed with the roller or with the House; the odds are even). The 
first roll is the roll immediately following a bet: 


1. On the first roll: 


7 or 11 wins for the roller; 
2,3, or 12 wins for the House; 
any other number is the point , roll again (Rule 2 
| applies). 
2. On subsequent rolls: 
point roller wins; 
7 House wins; 


any other number roll again. 


If a player loses the entire bankroll, the House will offer to lend the 
player an additional $2,000. The program will prompt: 


marker? 


A yes (or y ) consummates the loan. Any other reply terminates the 
game. 


If a player owes the House money, the House reminds the player, 
before a bet is placed, how many markers are outstanding. 


If, at any time, the bankroll of a player who has outstanding markers 
exceeds $2,000, the House asks: 
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Repay marker? 


A reply of yes (or y ) indicates the player's willingness to repay the 
loan. If only 1 marker is outstanding, it is immediately repaid. How- 
ever, if more than 1 marker are outstanding, the House asks: 


How many? 


markers the player would like to repay. If an invalid number is 
entered (or just a carriage return), an appropriate message is 
printed and the program will prompt with How many? until a valid 
number is entered. 


lf a player accumulates 10 markers (a total of $20,000 borrowed 
from the House), the program informs the player of the situation and 
exits. 


Should the bankroll of a player who has outstanding markers 
exceed $50,000, the tota/ amount of money borrowed will be 
automatically repaid to the House. 


Any player who accumulates $100,000 or more breaks the bank. 
The program then prompts: 


New game? 
to give the House a chance to win back its money. 


Any reply other than yes is considered to be a no (except in the 
case of bet? or How many? ). To exit, send an interrupt (break), 
DEL, or control-D. The program will indicate whether the player 
won, lost, or broke even. 


MISCELLANEOUS 


The random number generator for the die numbers uses the 
seconds from the time of day. Depending on system usage, these 
numbers, at times, may seem strange but occurrences of this type 
in a real dice situation are not uncommon. 
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_ NAME 3 a 
hangman — guess the word | | _ © 
SYNOPSIS 
/usr/games/hangman [ arg |] 
DESCRIPTION 


_ Hangman chooses a word at least seven letters long from a diction- 
_ ary. The user is to guess letters one at a time. 


The optional argument arg names an alternate dictionary. 


FILES 
/usrlib/w2006 


BUGS 
Hyphenated compounds are run together. 
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NAME 
maze — generate a maze 


SYNOPSIS 
/usr/games/maze 


DESCRIPTION : 
Maze asks a few questions and then prints a maze. 


BUGS 
Some mazes (especially small ones) have no solutions. 
Doesn't ask any questions and doesn't fit on a screen. 
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NAME 
moo — guessing game 


SYNOPSIS 
/usr/games/moo 


DESCRIPTION : | 
Moo is a guessing game imported from England. The computer 
picks a number consisting of four distinct decimal digits. The player 
guesses four distinct digits being scored on each guess. A ‘cow’ is 
a correct digit in an incorrect position. A “bull” is a correct digit in a 
correct position. The game continues until the player guesses the 
number (a score of four bulls). 
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NAME 

quiz — test your knowledge 
SYNOPSIS 

/usr/games/quiz [ -i file | [ -t ] [ category1 category2 | 
DESCRIPTION 7 


Quiz gives associative knowledge tests on various subjects. It asks 
items chosen from category? and expects answers from category2 
, or vice versa. If no categories are specified, quiz gives instruc- 
tions and lists the available categories. 


Quiz tells a correct answer whenever you type a bare new-line. At 
the end of input, upon interrupt, or when questions run out, guiz — 
reports a score and terminates. . 


The -t flag specifies “tutorial” mode, where missed questions are 
repeated later, and material is gradually introduced as you learn. 


The -i flag causes the named file to be substituted for the default 
index file. The lines of these files have the syntax: 


line = category new-line | category : line 
category = alternate | category | alternate 
alternate = empty | alternate primary 

primary = character |[ category ] | option 
option = { category } 


The first category on each line of an index file names an information 
file. The remaining categories specify the order and contents of the 
data in each line of the information file. Information files have the 
same syntax. Backslash \ is used as with sh (7) to quote syntacti- 
cally significant characters or to insert transparent new-lines into a 
line. When either a question or its answer is empty, quiz will refrain 
from asking it. 


FILES | 
'  /usrigames’lib: quiz/index 

/usr/games/lib/ quiz, * 

BUGS 
The construct “a|ab’ does not work in an information file. Use 
“a{b}”. 
Instructions scroll off-screen. Pipe to pg or more. Requires exact 
spelling. 
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NAME 


wump — the game of hunt-the-wumpus 


SYNOPSIS 


/usr/games/wump — 


DEORE EOn 


BUGS 
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Wump plays the game of “Hunt the Wumpus.” A Wumus is a 
creature that lives in a cave with several rooms connected by tun- 
nels. You wander among the rooms, trying to shoot the Wumpus 
with an arrow, meanwhile avoiding being eaten by the Wumpus and 
falling into Bottomless Pits. There are also Super Bats which are 
likely to pick you up and drop you in some random room. 


The program asks various questions which you answer one per line; 
it will give a more detailed description if you want. 


This program is based on one described in People's Computer 


Company , 2, 2 (Nevember 1973). 


It will never replace Adventure. 
Instructions run off the screen. 
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